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INTRODUCTION 


T his book—ten chapters, one appendix, and one glossary— is for 
beginning system administrators, system administrators new to the 
Solaris® 2.x environment, or any user who wants a task-oriented 
quick-reference guide to basic administrative commands. 

A Quick Tour of the Contents 

Chapter 1, “Introducing Solaris System Administration,” describes basic administration tasks, 
superuser status, and how to communicate with users, start up and shut down systems, and 
monitor processes. It also introduces some frequently used commands and the Administration 
Tool new to the Solaris 2.x environment. 

Chapter 2, “Using Basic OS Commands,” describes basic commands for finding user 
information and environment information for creating and editing files, combining 
commands and redirecting output, displaying manual pages, and locating disk information. 

Chapter 3, “Administering Devices,” describes how to use tapes and diskettes to store and 
retrieve files, and how to administer disks. It also introduces the Service Access Facility and 
provides instructions for setting up port monitors for printers and modems. 

Chapter 4, “Administering File Systems,” describes the types of file systems provided in the 
Solaris 2.x environment, the default file system, the virtual file system table, and the file 
system administrative commands. It shows you how to make file systems available and how 
to back up and restore file systems. 

Chapter 5, “Administering Network Services,” describes commands used to check on remote 
system status, log in to remote systems, and transfer files between systems. It also describes 
how to use the Administration Tool to make changes to NIS-(- databases once NIS-i- is up and 
running. 

Chapter 6, “Administering Printing,” introduces the LP print service, which is completely 
different from the print service of the SunOS 4.x system software. It describes how to set up 
printing services and how to use the printing commands. 

Chapter 7, “Administering User Accounts and Groups,” describes how to add and remove 
user accounts and how to set up new group accounts. 

Chapter 8, “Understanding Shells,” describes some commands common to all shells and 
provides basic information about the Bourne, C, and Kom shells. 

Chapter 9, “Administering Systems,” describes commands used to display system-specific 
information, configure additional swap space without reformatting a disk, and create a local 
mail alias. 

Chapter 10, “Recognizing File Access Problems,” provides information on how to recognize 
problems with search paths and with permissions and ownership. 


V 





Appendix A, “Major Differences; SunOS 4.x versus SunOS 5.x Operating Systems,” briefly 
describes key differences between SunOS 4.x and SunOS 5.x system software and provides a 
table of SunOS 4.x commands with the SunOS 5.x equivalents. 

The Glossary contains basic system administration terms and definitions. 


Important: Read This Before You Begin 

Because we assume that the root path will include the /sbin, /usr/sbin, /usr/bin, and /etc 
directories, the steps show the commands in these directories without absolute path names. 
Steps that use commands in other, less common directories show the absolute path in the 
example. 

The examples in this book are for a basic SunOS 5.x software installation without the Binary 
Compatibility Package installed and without /usr/ucb in the path. 

CAUTION! If lusriucb is included in a search path, it should always be at the end. Com¬ 
mands like ps or df are duplicated in /usr/ucb with different formats and options from 
those of SunOS 5.x commands. 

This book does not contain all the information you need to administer systems. Refer to the 
complete system administration documentation for comprehensive information. See 
Appendix A for discussion of the differences between the Solaris 1.0 (SunOS 4.x) and Solaris 
2.x (SunOS 5.x) environments. 

Because the SunOS 5.x system software provides the Bourne (default), Kom, and C shells, 
examples in this book show prompts for each of the shells. The default C shell prompt is 
system-naine%. The default Bourne and Kom shell prompt is $. The default root prompt for all 
shells is a pound sign (#). In examples that affect more than one system, the C shell prompt 
(which shows the system name) is used to make it clearer when you change from one system 
to another. 


Conventions Used in This Book 

Commands In the steps and the examples, the commands to be entered are in bold type. 
For example: “Type su and press Return.” When following steps, press Return only when 
instracted to do so, even if the text in the step breaks at the end of a line. 

Variables Variables are in an italic typeface. When following steps, replace the variable 
with the appropriate information. For example, to print a file, the step instructs you to “type 
Ip filename and press Return.” To substitute the file named “quest” for the filename variable, 
type Ip quest and press Return. 
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SPARC and x86 Information 


Mouse-Button Terminology This book describes mouse buttons by function. The 
default mapping of mouse buttons on a three-button mouse is: 

■ SELECT is Left 

■ ADJUST is Middle 

■ MENU is Right 

The SELECT mouse button is used to select unselected objects and activate controls. The 
ADJUST mouse button is used to adjust a selected group of objects, either adding to the 
group or deselecting part of the group. The MENU mouse button is used to display and 
choose from menus. 

Storage-Medium Terminology In this book, we distinguish between three different 
types of media storage terminology in this way: 

■ Disc is used for an optical disc or CD-ROM. 

■ Disk is used for a hard-disk storage device. 

■ Diskette is used for a floppy diskette storage device. (Note: Sometimes, screen 
messages use the term floppy.) 

Icons Marginal icons distinguish between three different types of information: 

■ The New with SVR4 icon marks material that is new with Solaris 2.x system software 
(not available in Solaris 1.x). 

■ The New with 2.6 icon marks features that are new with Solaris 2.6 system software. 


■ The New in this edition icon marks new information that has been added to this 

edition. Some of the new information describes new commands and features that were 
introduced between the Solaris 2.1 and 2.5.1 releases. Other new information was 
available in the Solaris 2.0 release but was not included in the first edition. Where 
possible, the text next indicates the release number where the command or 
functionality was added. 

SPARC and x86 Information 

This book provides system administration information for both SPARC and x86 systems. 

Unless otherwise noted, information throughout this book applies to both types of 
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systems. Table I-l summarizes the differences between the SPARC and x86 system 
administration tasks. 


Table 1-1 SPARCand x86 System Adminstration Differences 


Category 

SPARC 

x86 

System operation before 
kernel is loaded 

A programmable read-only memory (PROM) 
chip with a monitor program runs 
diagnostics and displays device information. 

The basic input/output system 
(BIOS) runs diagnostics and 
displays device information. 


The PROM is also used to program default 
boot parameters and test the devices 
connected to the system. 

A Solaris Device Configuration 
Assistant boot diskette with the 
Multiple Device Boot (MDB) 
program is used to boot from 
non-default boot partitions, the 
network, or the CD-ROM. 

Booting the system 

Commands and options at the PROM level 
are used to boot the system. 

Commands and options at the 
MBD, primary, and secondary 
boot subsystems level are used 
to boot the system. 

Boot programs 

bootbik, the primary boot program, loads 
ufsboot. 

mboot, the master boot record, 
loads pboot. 


ufsboot, the secondary boot program, loads 
the kernel. 

pboot, the Solaris partition boot 
program, loads bootbik. 



bootbik, the primary boot 
program, loads ufsboot. 



ufsboot, the secondary boot 
program, loads the kernel. 

System shutdown 

The shutdown and init commands can be 
used without additional operation 
intervention. 

The shutdown and init 
commands are used but require 
operator intervention at the type 
any key to continue prompt. 

Disk controllers 

SCSI 

SCSI and IDE 

Disk slices and partitions 

A disk may have a maximum of eight slices, 
numbered 0-7. 

A disk may have a maximum of 
four fdlsk partitions. 



■ The Solaris fdisk partition may 
contain up to 10 slices, 
numbered 0-9, but only 0-7 
can be used to store user data. 

Diskette drives 

Desktop systems usually contain one 

3.5-inch diskette drive. 

Systems may contain two 
diskette drives: a 3.5-inch and 
a 5.25-inch drive. 
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To help you understand how Solaris is evolving, Table 1-2 provides a list of the major 
system administration feature differences for each release. 


Table 1^2 Solaris System Software Evolution 

Release New Features 

Solaris 1.0 Berkeley (BSD) UNIX with Solaris 4.xfunctionality. 

Solaris 2.0 (SunOS A merger of AT&T System V Release 4 (SVR4) and BSD UNIX. To facilitate customer 

5.0) transition, Solaris uses SVR4 as the default environment, with BSD commands and modes 

as an option. Administration Tool provides a graphical user interface Database Manager and 
Host Manager. 

Solaris 2.1 (SunOS Administration Tool adds a graphical user interface Printer Manager and User Account 

5.1) Manager. 

Solaris 2.2 (SunOS Volume management integrates access to CD-ROM and diskette files with the File Manager, 

5.2) and provides a command-line interface. Users no longer need superuser privileges to mount 
CD-ROMs and diskettes, Solaris 2.0 and 2.1 procedures do not work with volume 
management because volume management controls and owns the devices. (Refer to 
Appendix A of the Solaris Advanced System Administrator’s Guide.) 

Solaris 2.3 (SunOS Volume management changes Solaris 2.2 mount point naming conventions. 

5.3) 


Administration Tool adds a graphical user interface Serial Port Manager with templates that 
provide default settings, which makes adding character terminals and modems much easier. 

The automounter is split into two programs: an automounted daemon and a separate 
automount program. Both are run when the system is booted. The /tr)ip_nint mount point 
is not displayed as part of the path name, and the local path Is displayed as 
/home/username. Additional predefined automount map variables are provided, (Refer to 
the Solaris Advanced System Administrator's Guide.) 

Online: Backup 2.1 Is included with the release (Not documented in this book.) 

Pluggable Authentication Model (PAM) is Included with the release. PAM provides a 
consistent framework to allow access control applications, such as login, to be able to 
choose any authentication scheme available on a system, without concern for 
implementation details of the scheme. (Not documented in this book.) 

C2 Security is included in this release. (Not documented in this book.) 

Format(l) changes for SCSI disks. (Not documented in this book.) 

PPP network protocol product that provides IP network connectivity over a variety of 
point-to-point connections is included in this release. (Not documented in this book.) 

Cache File System (CacheFS) for NFS is included in this release, CacheFS is a generic, 
nonvolatile caching mechanism to improve performance of certain file systems by using a 
small, fast, local disk. (New in this edition.) 






Table 1-2 Solaris System Software Evolution (continued) 

Release New Features 

New NIS+ setup scripts are inQluded in this release. The nisserver(lM), 
nispopulate{lM), and nisclient{lM) scripts described in Table 1.2 let you set up an 
NIS+ domain much more quickly and easily than if you used the individual NIS+ commands 
to do so. With these scripts, you can avoid a lengthy manual process. 


Solaris 2.4 (SunOS New Motif GUI for Solaris software installation. (Not documented in this book.) 

5.4) 


Solaris 2.5 (Solaris New pax(lM) portable archive Interchange command for copying files and file systems to 

5.5) portable media. 

Solstice AdminTools utility used only to administer local systems. 

Solstice AdminSuite product available for managing systems in a network for SPARC and 
x86 systems. 

New process tools are available In /usr/proc/bin that display highly detailed information 
about the active processes stored in the process file system in the /proc directory. 

Telnet client upgraded to the 4.4 BSD version, rlogln and telnetd remote login capacity 
improved. (Not documented In this book.) 

Solaris 2.5.1 The limit on user ID and group ID values has been raised to 2147483647, or the maximum 

(SunOS 5.5.1) value of a signed integer. The nobody user and group (60001) and the no access user and 

group (60002) retain the same UID and GID as in previous Solaris 2.x releases. 

Solaris 2.6 (SunOS Changes to the Solaris 2.6 printing software provide a better solution than the LP print 

5.6) software in previous Solaris releases. You can easily set up and manage print clients using 
the NiS or NIS+ name services to enable centralization of print administration for a network 
of systems and printers. New features include redesign of print packages, print protocol 
adapter, bundled SunSoft Print Client software, and network printer support. 

New nisbackup and nisrestore commands provide a quick and efficient method of 
backing up and restoring N!S+ namespaces. 

New patch tools, including patchadd and patchrm commands, add and remove patches. 
These commands replace the installpatch and backoutpatch commands that were 
previously shipped with each individual patch. (Refer to the Solaris Advanced System 
Administrator’s Guide.) 

New f ilesync command nomadic support ensures that data is moved automatically 
between a portable computer and a server. (Not documented in this book.) 

Restructuring of the previous flat /proc file system into a directory hierarchy contains 
additional subdirectories for state information and control functions. It also provides a 
watchpoint facility to monitor access to and modifications of data in the process address 
space. The adb(l) command uses this facility to provide watchpoints. 

Large files are supported on UFS, NFS, and CacheFS file systems. Applications can create 
and access files up to one Tbyte on UFS-mounted file systems and up to the limit of the 
NFS server for NFS- and CacheFS-mounted file systems. A new -mount option is provided 
to disable the large-file support on UFS file systems. Using the -mount option enables 
system administrators a way to ensure that older applications that are not able to safely 
handle large files do not accidentally operate on large files. 
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Table 1-2 Solaris System Software Evolution (continued) 

Release New Features 

NFS Kerberos authentication now uses DES encryption to Improve security over the network. 
The kernel implementations of NFS and RPC network services now support a new RPC 
authentication flavor that is based on the Generalized Security Services API (GSS-APl). This 
support contains the hooks to add stronger security to the NFS environment. (Refer to the 
Solaris Advanced System Administrator’s Guide.) 

The PAM authentication modules framework enables you to "plug in" new authentication 
technologies. (Refer to the Solaris Advanced System Administrator's Guide.) 

Font Admin enables easy Installation and use of fonts for the X Window System. It supports 
TrueType, TypeO, Typel, and CID fonts for multibyte languages and provides comparative 
font preview capability. It is fully integrated into the CDE desktop. (Not documented In this 
book.) 

TrueType fonts are supported through X and Display PostScript. Font Admin enables easy 
installation and integration of third-party fonts into the Solaris environment. (Not docu¬ 
mented in this book.) 

The Solaris 2.6 operating environment is year 2000 ready. It uses unambiguous dates and 
follows the X/Open guidelines where appropriate. (Not documented In this book.) 

WebNFS software enables file systems to be accessed through the Web using the NFS 
protocol. This protocol is very reliable and provides greater throughput under a heavy load. 
(Not documented in this book.) 

The Java Virtual Machine 1.1 integrates the Java platform for the Solaris operating 
environment. It includes the Java runtime environment and the basic tools needed to 
develop Java applets and applications. (Not documented in this book.) 

For x86 systems, the Configuration Assistant interface is part of the new booting system for 
the Solaris (Intel Platform Edition) software. It determines which hardware devices are in the 
system, accounts for the resources each device uses, and enables users to choose which 
device to bool from. (Not documented in this book.) 

For x86 systems, the kdmconf ig program is used to configure the mouse, graphics 
adapter, and monitor. If an Owconf ig file already exists, kdmconf ig extracts any usable 
information from it. In addition, this updated version of kdmconf ig also retrieves 
information left in the devinf o tree by the defconf program and uses that information to 
automatically Identify devices. (Not documented in this book.) 


Full X/Open UNIX 95, POSIX 1003.1b and ISO 10646 standards compliance. (Not 
documented in this book.) 
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Defining the System Administrator’s Job 


Winchester Mystery House [in San Jose, California ]... was designed to baffle the evil 
spirits that haunted Sarah Winchester, eccentric heiress to the Winchester Arms fortune 
and mistress of the house. With 160 rooms and 2,000 doors, 13 bathrooms, 10,000 win¬ 
dows, 47 fireplaces, blind closets, secret passageways and 40 staircases, the house is so 
complex that even the owner and servants needed maps to find their way. 

— AAA, California/Nevada TourBook, 1991 

Sarah Winchester, listening to the advice of psychics, believed that if she kept adding rooms 
to the house, she would not die and be subject to the influences of spirits who had been killed 
with the Winchester rifles manufactured by her husband. 

The UNIX operating system is much like the Winchester Mystery House without, we hope, 
the evil spirits. The original operating system has been continually enhanced and expanded. 
There are many ways to get about, and, like the owner and the servants in the Winchester 
house, system administrators frequently need a map to help them get from place to place. 

To add to the complexity, there are many versions of the UNIX operating system based on 
either Berkeley (or BSD) UNIX or AT&T’s System V. This book serves as a map to some of 
the most frequently used “rooms” of the SunOS 5.jc system software, which is an enhanced 
implementation of UNIX System V, Release 4 (usually referred to as SVR4). The book also 
provides comparative information to help you learn the differences between the SunOS 4.x 
versions (the BSD UNIX operating system) and the SunOS 5.x version (the SVR4 operating 
system). 


Defining the System Administrator’s Job 

The system administrator’s job is to keep the software (and perhaps hardware) functioning 
for a stand-alone system or for a set of systems on a network so that others can use them. 

Typical duties of system administrators vary, depending on the number of systems supported 
and how the duties are divided up. It is not uncommon for system administrators to be 
experts in administering one or more areas and be inexperienced in others. Some 
administrators specialize in network administration; others in user accounts; and still others 
in areas such as printing. 

Here’s a list of typical system administration duties that are described in part or in full in this 
book: 

■ Administering devices 

■ Using tape cartridges 

■ Formatting diskettes 

■ Monitoring disk use 
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■ Understanding the Service Access Facility 
H Setting up a bidirectional modem 

■ Administering file systems 

■ Mounting and unmounting file systems 

■ Backing up and restoring files and file systems 

■ Administering network services 

■ Finding network information 

■ Transferring files between systems 

■ Administering NIS+ databases 

■ Administering printing 

■ Setting up a print client and print server 

■ Using printing commands 

■ Administering users and groups 

■ Adding users 

■ Removing users 

■ Changing user information 

■ Creating new group accounts 

■ Understanding shells 

■ Using Generic shell commands 

■ Using Bourne shell commands 

■ Using C shell commands 

■ Using Korn shell conunands 

■ Administering systems 

■ Finding system information 

■ Creating local mail aliases 

■ Configuring additional swap space 

■ Administering the system date and time 

■ Recognizing file access problems 

■ Problems with search paths 

■ Problems with permission and ownership 

■ Problems with network access 







Understanding Superuser Status 


5 


The organization of this book matches the tasks listed above. To accomplish these tasks, 
you need to know when and how to: 

■ Gain full access to all file systems and resources 

■ Communicate with users 

■ Shut down and start up systems 

■ Monitor processes 

However, information about the following system administration tasks is beyond the scope 
of this book: installing system software, installing third-party software, setting up and 
administering network services, setting up and administering mail services, adding and 
removing hardware, administering security and accounting, and monitoring system and 
network performance. 

The rest of the sections in this chapter, which describe how to accomplish the system 
administrator’s tasks, introduce some basic commands and administrative tools. 


Understanding Superuser Status 

The superuser is a privileged user with unrestricted access to all files and commands. The 
superuser has the special UID (user ID) 0. The user name for this account is root. Note 
that the terms root and superuser have the same meaning and are used interchangeably in 
this book. You must be root to perform many system administration tasks, such as 
mounting and unmounting file systems, changing ownership or permissions for a file or 
directory you do not own, backing up and restoring file systems, creating device files, and 
shutting down the system. 

You can become superaser in two ways: 

■ When logged in as another user, by typing the su (switch user) command with no 
arguments, and then typing the root password 

■ From a login prompt, by typing root and then typing the root password 

When you have superuser privileges, the shell provides a special # (pound sign) prompt to 
remind you that you have extra access to the system. The system keeps a log that records 
each time the su command is used and who uses it. You can keep track of who is using the 
superaser'account by consulting the log file /var/adm/sulog. 

You should only become superuser when it is required and avoid doing routine work as 
superuser. Occasionally, you may need to log out of your user account and log in again as 
root. When a task requires you to log in as root, you will be instructed to do so. You 
should switch user (su) to root, perform the required tasks, and exit superaser status when 
the tasks are complete. 
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Because unauthorized access to root can be a serious security breach, always add a 
password to the root account. For enhanced security, change the root password frequently. 

NOTE. The default shell for root is the Bourne shell. See Chapter 8 for more informa¬ 
tion. 

Becoming Superuser (sir) 

You should become superuser only when you need to perform a task that requires root 
permissions. Here’s how to become superuser: 

1. At the shell prompt ($ or %), type su and press Return. You are prompted for the 
superuser (root) password, if one has been set up. 

2. Type the superuser password and press Return. If you enter the password correctly, 
you have superuser (root) access to the system and the root prompt (#) is displayed: 

oak% su 
Password: 

# 

If you want to use root’s environment variables, type su - and press Return. 

Exiting Superuser Status 

To exit superuser status, simply type exit and press Return. The shell prompt is 
redisplayed; 

# exit 
oak% 

Logging In as Root 

To log in as root, you must be at a login prompt: 

1. At a login prompt, type root and press Return. You are prompted for the root 
password. 

2. Type the root password and press Return. If you enter the password correctly, you 
have superuser (root) access to the system, and the root prompt (#) is displayed: 

login: root 
Password: 

# 

Communicating with Users 

An important part of your job as a system administrator is communicating with users to let 
them know that a task you are performing will affect their ability to use a system. Always 
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let users know when you are about to perform a task that will affect them, such as 
rebooting a system, installing new software, or changing the environment in some way. 

You can communicate with users by personal visit or phone, but the most common way is 
by using the system to: 

■ Display a system-specific message at login using the rhessage of the day. 

■ Send a message direcdy to an individual user’s terminal using the write command. 

■ Send a message to all users on a system using the wall command. 

■ Send a message to all users on a network using the rwall command. 

■ Send a message to an individual or a group of users by electronic mail. 


Displaying System-Specific Messages at Login 

Each time a user logs in to a system, the message of the day in the file /etc /motd is 
displayed. The message is not displayed to users who are already logged in and are using 
the system. Use motd to give users information specific to the system which someone 
logging in would want to know. This information might include which operating system 
release is installed, changes to system software, the name of the newly installed (or 
deleted) third-party software, or a list of scheduled downtimes. 

Be sure to keep the motd file current. If motd displays outdated messages, users may begin 
to ignore all the messages, thereby missing out on critical information when it is 
presented. Keep the message short: If the message is longer than a screenful of 
information, users won’t be able to read the beginning. 

Root should own the /etc /motd file and be the only user who has write permission to it: 
oak% Is -1 /etc/motd 

-rw-r--r-- 1 root sys 49 Jan 1 1970 /etc/motd 

oak% 

NOTE. When the system software is installed, several files, including /etc/motd, have a 
time stamp of “Jan 11970. ” This date is the beginning of UNIX time. When you edit 
these files, the time stamp is updated. 

Creating a Message of the Day 

Follow these steps to create a message of the day: 

1. Become superuser. 

2. Use an editor such as vi to edit the /etc/motd file. 

3. Delete any obsolete messages and type the new one. 

4. Save the changes. The message is. changed and is displayed the next time a user logs 
in to the system. 
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Sending a Message to an Individual User 

You can send a message to the terminal of an individual user using the write command. 
When using a windowing system such as CDE or OpenWindows, each window is 
considered a separate login. If the user is logged in more than once, the message is 
directed to the console window. 

Typing a Short Message to an Individual User 

Use these steps to send a short, one-time message to an individual user: 

1. Type write username and press Return, username is the login name of the user. 

2. Type the message you want to send. 

3. When the message is complete, press Control-D. The message is displayed in the 
user’s console window. 

Here is an example of a message a system administrator might type; 
oak% write ignatz@elni 

I'll come by at 12:00 to look at your problem. 
oak% 

This is how the message would display in the user’s console window: 

Message from fred@oak on ttypi at 11:20 ... 

I'll come by at 12:00 to look at your problem. 

EOF 

Sending a Message from a File to an Individual User 

If you have a longer message that you want to send to a number of users, follow these 
steps to create the message in a file and then use the file name as an argument to the write 
command: 

1. Create a file containing the text of the message you want to send. 

2. Type write username < filename and press Return. 

In this example, the system administrator uses the cat command to create a file containing 
a short message: 

oak% cat > message 

I'll come by at 12:00 to look at your problem. 
oak% write ignatz^elm < message 

write: ignatz logged in more than once ... writing to console 
oak% 

If the user is logged in to more than one window, the message is displayed in the console 
window. This is how the message displays in the user’s console window: 

Message from fred@oak on ttypi at 11:20 ... 

I'll come by at 12:00 to look at your problem. 

EOF 
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As you can see, the user doesn’t see any difference in the output created from a typed 
message and the message included from a file. The user can initiate a dialogue by using 
the write command to respond, but the dialogue is not truly interactive. There are two 
write paths open, one in each direction. See the write(l) manual page for more 
information. For more information about manual pages, see Chapter 2, “Using Basic OS 
Conunands.” 

Sending a Message to All Users on a System or Network 

You can use the wall (write all) command to simultaneously send a message to every user 
on a system. You can use the rwaii (remote write all) command to simultaneously send a 
message to every user on a network. 

To send a message to all users on a system: 

1. Type wall and press Return. 

2. Type the message you want to send. 

3. When the message is complete, press Control-D. The message is displayed in the 
console window of each user on the system. 

This is an example of a message a system administrator might type: 

oak% wall 

System will be rebooted at 12:00. 
oak% 

This is how the message would display in the users’ console windows; 

Broadcast message from root on console ... 

System will be rebooted at 12:00. 

EOF 

NOTE. Use the rwall command carefully because it consumes extensive system and net¬ 
work resources. 

To send a message to all users on a network: 

1. Type rwall -n and press Return. 

2. Type the message you want to send. 

3. When the message is complete, press Control-D. The message is displayed in the 
console window of each user on the system. 

This is a message the system administrator might type to send to all members of the 
netgroup Eng; 

oak% rwall -n Eng 

System oak will be rebooted at 12:00. 
oak% 
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This is how the message would display in the users’ console windows: 

Broadcast message from root on console ... 

System will be rebooted at 12:00. 

You can also use the rwall command to send a message to all users on a system by typing 

rwall hostnaae. 


Sending a Message by E-Mail 

E-mail is an effective way to communicate some system administration informational 
messages. However, this book does not describe how to use electronic mail. See the 
mail(l), mailtool(l), mailx(l), and dtmail(lX) manual pages for information about the 
mail programs. 

Starting Up and Shutting Down Systems 

Starting up and shutting down systems is an integral part of performing system 
administration tasks. This section describes procedures for routinely starting up and 
shutting down systems. If a system does not start up gracefully, see your system 
documentation for information on how to diagnose booting problems. 

The SunOS 5.x system software is designed to be left running continuously so that the 
e-mail and network software can work correctly. You must, however, halt or shut down a 
system when: 

■ Turning off system power 

■ Installing a new release of the operating system 

■ Anticipating a power outage 

■ Adding hardware to the system 

■ Performing maintenance on a file system 


Choosing an Init State 

The init state (also called run level) determines what programs are started or initialized 
when a system is booted. The SunOS system software has eight init states; the default init 
state for each system is specified in the /etc /inittab file. The default init state for the 
SunOS 5.x system software is run level 3. Table 1-1 shows the seven available run levels 
and the state of the system at each level. 

The /sbin / init command is responsible for keeping the system running correctly and is 
the conunand you use to change init states. You can also use the init states (with the -i 
option) as arguments to the shutdown command. There are four types of system states: 
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Table 1-1 


Init State 

0 

1, s, s 
2 

3 

4 

5 

6 


System Init States 

Function 

Power-down state 

System administrator state (single-user) 
Multiuser state (resources not exported) 
Multiuser state (resources exported) 
Alternative multiuser state (currently unused) 
Software reboot state (unused) 

Reboot 


■ Power-down (run level 0) 

a Single-user (run levels 1 and s or S) 
m Multiuser (run levels 2 and 3) 

■ Reboot (run levels 5 and 6) 


When preparing to do a system administration task, you need to determine which init 
state is appropriate for the system and the task at hand. 



Finding the Run Levei for a System 

To find the run level for a system, type who - r and press Return. The run level, date and 
time, process termination status, process ID, and process exit status are displayed. 


In this example, the system named drusilla is at the default multiuser run level (3), the 
date and time are Feb 6 15: 46, the process termination status is 3, the process ID is 0, and 
process exit status is S: 


drusilla% who -r 

. run-level 3 Feb 6 15:46 3 0 S 

drusilla^ 


The next sections describe how you might use each init state. 


Using Power-Down State, Run Levei 0 

Use this level to shut down the system so that it is safe to turn off the power. 

Using System Administrator State, Run Levei 1 

Use this level when performing administrative tasks that require you to be the only user on 
the system. Root and /usr are the only file systems mounted, and you can access only 
minimum kernel utilities. The terminal from which you issue the init i command 
becomes the console. No other users are logged in. 
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Using Multiuser State, Run Level 2 

Use this level for normal operations. Multiple users can access the system and the entire 
file system. All daemons are running except for NFS server, syslog, and remote file 
sharing. 

NOTE. A daemon is a special type of program that, once activated, starts itself and car¬ 
ries out a specific task without any need for user input. Daemons typically are used to 
handle jobs that have been queued, such as printing, mail, and communication. 

Using Remote Resource-Sharing State, Run Level 3 

Use this level for normal operations with NFS resource-sharing available. 

Using Alternative Multiuser State, Run Level 4 

This level currently is unavailable. 

Using Interactive Reboot State, Run Level 5 

Use this level when you want to be prompted for a device other than the default boot 
devices. You can also change to this level using the reboot -a command. 

Using Reboot State, Run Level 6 

Use this level to shut down the system to run level 0, and then reboot to multiuser level (or 
to whatever level is the default in the inittab file). 

Using Single-User State, Run Level s or S 

Use this level to run as a single user with all file systems mounted and accessible. 

Changing Run Levels 

Use either the telinit or init command to change run levels. The telinit command 
takes a one-character argument that tells init what run level to use. Although you can use 
the init command directly, telinit is the preferred conunand to use to change system mn 
states. 

To change mn levels: 

1. Become supemser. 

2. Type telinit n and press Return. Replace the variable n with the number of the init 
state you want to use. 

To shut down the system: 

oak% su 
Password: 

# telinit 0 


To change to single-user state: 
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oak% su 
Password: 

# telinit 1 

To change to multiuser state, with no NFS server daemons: 

oak% su 
Password: 

# telinit 2 

To change to multiuser state, wi± NFS server daemons: 

oak% su 
Password: 

# telinit 3 

To shut down and reboot a system: 

oak% su 
Password: 

# telinit 6 

Choosing Which Shutdown Command to Use 

When preparing to do a system administration task, you need to determine which 
shutdown command is appropriate for the system and the task at hand. The next sections 
describe how you might use each of the available shutdown commands: 

■ /usr/sbin/shutdown 

■ /etc/telinit and /sbin/init 

■ /usr/sbin/halt 

■ /usr/sbin/reboot 

These commands, respectively, initiate shutdown procedures, kill all running processes, 
write out any new data to the disk, and shut down the SunOS 5.jc system software to the 
appropriate run level. 

shutdown 

Use the shutdown command when shutting down a system with multiple users. The 
shutdown command sends a warning message to all users who are logged in, waits 60 
seconds (the default), and then shuts down the system to single-user state. You can choose 
a different default wait time. 

telinit and init 

m Use the telinit or init command to shut down a single-user system or to change its 
run level. The init command changes the run level of the system. The telinit 
command tells init what run level you want. You can use the commands 
interchangeably, but telinit is the preferred command. You can use telinit to place 
the system in power-down state (init 0 ) or in single-user state (init 1). 
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NOTE. Use telinit /init and shutdown as the preferred method of changing system 
state. These programs are the most reliable way to shut down a system because they use a 
number of rc scripts to kill running processes. 

halt 

Use the halt command when the system must be stopped immediately and it is acceptable 
not to warn any current users. The halt command shuts down the system without any 
delay and does not warn any other users on the system. The halt command does not run 
the rc shutdown scripts properly and is not the preferred method for shutting down a 
system. 

reboot 

Use the reboot command to shut down a system that does not have multiple users to bring 
it back into multiuser state. The command reboot does not warn users on the system, does 
not run the rc scripts properly, and is not the preferred method for shutting down a system. 


Booting a System 

If a system is powered off, turning it on starts the multiuser boot sequence. The following 
procedures tell you how to boot in different states from the ok PROM prompt. If the 
PROM prompt is >, type n to display the ok prompt, and then follow the appropriate steps. 

NOTE. The PROM prompt description is for SPARC systems. 

Booting in Multiuser State 

To boot in multiuser state, at the ok PROM prompt, type boot and press Return. The 
automatic boot procedure starts on the default drive, displaying a series of start-up 
messages. The system is brought up in multiuser state. 

Booting in Single-User State 

To boot in single-user state, at the ok PROM prompt, type boot -s and press Return. The 
system boots to single-user state and prompts you for the root password: 

ok boot -s 

INIT: SINGLE USER MODE 

Type Ctrl-d to proceed with normal start-up, 

(or give root password for system maintenance) 

Type the root password and press Return. 

NOTE. To continue the process and bring the system up in multiuser state, press 
Control-D. 






IS 


starting Up and Shutting Down Systems 


Booting Interactively 

You may boot interactively if you want to make a temporary change to the system file or 
the kernel. In this way, you can test your changes and recover easily if you have any 
problems: 

1. At the ok PROM prompt, type boot -a and press Return. The boot program prompts 
you interactively. 

2. Press Return to use the default / kernel / unix kernel, or type the name of the kernel 
to use for booting. 

3. Press Return to use the default /etc /system file, or type the name of the system file 
and press Return. 

4. Press Return to use the default modules directory path, or type the default path for 
the modules directory and press Return. 

5. Press Return to use the default root file system. Type uf s for local disk booting or 
nf s for diskless clients. 

6. Press Return to use the default physical name of the root device, or type the device 
name. 

7. Press Return to use the swapf s default swap file system type, (Note that swapf s is the 
only permitted swap file system type.) 

In the following example, the default choices (shown in square brackets [ ]) were accepted 
by pressing Return: 

ok boot -a 

(Hardware configuration messages) 
rebooting from -a 

Boot device: /sbus/esp@0,800000/sd@0,0 File and args; -a 
Enter <filename> [/kernel/unix]: 

(Copyright notice) 

Name of system file [/etc/system]: 

Name of default directory for modules [<null string>]: 
root filesystem type [ufs] 

Enter physical name of root device 
[/sbus@1,f8000000/esp@0,800000/sd00,0;a]: 

Swap filesystem type [swapfs] 

Configuring network interfaces: le0 
Hostname: Cinderella 
(fsck messages) 

The system is coming up. Please wait. 

(More messages) 

Cinderella login: 

Looking at the Boot Messages 

The most recent boot messages are stored in the / var /adm /messages file. To see these 
messages after you have booted the system, type /usr/sbin/draesg and press Return. The 
boot messages are displayed. Or, type more /var/adm/raessages and press Return. 
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NOTE. You cannot view /usr/sbin/dmesg text from a CDE terminal window. If you are 
running CDE, use more /var/adm/messages to review boot messages. Alternatively, you 
can open a Command Tool window by typing /usr/openwin/bin/cmdtool& and use that 
window to view /usr/sbin/dmesg text. 

This example shows the contents of the dmesg file: 

castle% /usr/sbin/dmesg 

Sep 13 10:53 

SunOS Release 5.6 Version Generic [L)NIX(R) System V Release 4.0] 

Copyright (c) 1983-1997, Sun Microsystems, Inc. 
pac: enabled - SuperSPARC/SuperCache 

cpu0: TI,TMS390Z55 (mid 8 impl 0x0 ver 0x1 clock 50 MHz) 

mem = 65536K (0x4000000) 

avail mem = 61177856 

Ethernet address = 8:0:20:18:69:71 

root nexus = SUNiVjSPARCstation- 

iommu0 at root: obio 0xe0000000 

sbus0 at iommu0: obio 0xe0001000 

espdma0 at sbus0: SBus slot f 0x400000 

esp0:esp-options=0x46 

esp0 at espdma0: SBus slot f 0x800000 spare ipl 4 
sd3 at esp0: target 3 lun 0 

sd3 is /iommu@f,60000000/sbusOf,e0001000/espdma@f,400000/esp@f,800000/sd@3,0 
<SEAGATE-ST51080N-0958 cyl 4824 alt 2 hd 4 see 109> 

root on /iommu@f,e0000000/sbus@f,60001000/espdma@f,400000/esp@f,800000/sd@3,0:a 
fstype ufs 
obio0 at root 

ZS0 at obio0: obio 0x100000 spare ipl 12 
ZS0 is /obio/zs@0,100000 
zs1 at obio0: obio 0x0 spare ipl 12 
zsi is /obio/zs@0,0 

cgsix0 at sbus0: SBus slot 3 0x0 SBus level 5 spare ipl 9 
cgsix0 is /iommu@f,e0000000/sbus@f,e0001000/cgsix@3,0 
cgsix0: screen 1152x900, single buffered, 1M mappable, rev 8 
epu 0 initialization complete - online 
dump on /dev/dsk/c0t3d0s1 size 112036K 
castle% 


Booting After Adding New Hardware 

When you add new hardware to your system, you must use the - r option to the boot 
command so that the operating system knows to look for new device drivers and 
incorporate them as part of the boot process: 

1. Load the new device driver, following the instructions included with the hardware. 

2. Shut down your system and install the new hardware. 

3. Type boot - r and press Return. A reconfiguration script is run to load all the device 
drivers listed in the modules directories and to create the corresponding hardware 
nodes. 
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Aborting a Booting Process 

Occasionally, you may need to abort the booting process. The specific abort key sequence 
depends on your keyboard type. For example, you might press Stop-A or Ll-A. On tty 
terminals, press the Break key. 

To abort the booting process, type the abort key sequence for your system. When you 
abort the boot process, the monitor displays the ok PROM prompt: 

ok 

Type boot and press Return to restart the boot process, or type help and press Return to 
display a list of help options. If your terminal shows the > monitor prompt, type n to get 
the ok prompt. 

Shutting Down a System 

The following sections describe how to use the shutdown and init commands to shut 
down a system. 

Shutting Down a Multiuser System 

Before shutting down a multiuser system, inform the other users on the system and give 
them time to complete critical procedures such as saving changes: 

1. Type who and press Return. A list of all logged in users is displayed. 

2. Type ps -ef and press Return. A list of system activities is displayed. If the activity 
is acceptable for running shutdown, go to the next step. 

3. Become superuser. 

4. Type cd / and press Return. You must be in the root directory to run the shutdown 
command. 

5. Type shutdown and press Return, You are asked to confirm that you want to shut 
down the system. 

6. Type y. A message is broadcast to all users. After a 60-second wait, the system is 
shut down to single-user state and you are prompted for the root password. 

7. Type the root password. The system is in single-user state and you can perform any 
maintenance task. 

8. Press Control-D to return to the default run system level: 

# cd / 

# shutdown 

Shutdown started Frl Aug 6 10:50:35 EOT 1993 

Broadcast message from root (console) on earth Fri Aug 9 10:59:35. 

THE SYSTEM IS' BEING SHUT DOWN NOW 1 ! 1 
LOG OFF NOW OR RISK YOUR FILES BEING DAMAGED 
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Do you want to continue? (y or n): y 
The system is down. 

Changing to init state s - please wait. 

INIT: New run level S 
INIT: SINGLE USER MODE 

Type Ctrl-d to proceed with normal start-up, 

(or give root password for system maintenance): 

Shutting Down a System: Alternative Ways 

If you want to change the default actions of the shutdown command, choose one of the 
tasks in the following six sections. 

Shutting Down a System Without Confirmation 

To shut down a system without confirmation, follow these steps: 

1. Become superuser. 

2. Type cd / and press Return. You must be in the root directory to run the shutdown 
command. 

3. Type shutdown -y and press Return. The shutdown proceeds without asking you to 
type y to confirm it. 

Changing the Shutdown Grace Period The default is for the shutdown command 
to provide a 60-second grace period to enable users to save their changes. To change the 
shutdown 60-second grace period, follow these steps: 

1. Become supemser. 

2. Type cd / and press Return. You must be in the root directory to run the shutdown 
command. 

3. Type shutdown -g ann and press Return. The grace period is changed to the number 
of seconds you specify. 

The following example changes the grace period to 120 seconds: 

# cd / 

# shutdown -gl20 

Shutting Down and Rebooting a Multiuser System To shut down and reboot a 
multiuser system, follow these steps: 

1. Become superuser, 

2. Type cd / and press Return. You must be in the root directory to run the shutdown 
command. 
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3. Type shutdown -16 and press Return. A message is broadcast to all users and the rc 
script is executed; the system is shut down to power-down state and then brought 
back up to multiuser state. 

Shutting Down a Single-User System To shut down a single-user system, type 
telinit 0 (or init 0) and press Return. The init command runs scripts that bring the sys¬ 
tem down cleanly. No warning messages are broadcast. 

Shutting Down and Rebooting a Singie-User System To shut down and reboot 
a single-user system, type telinit 6 (or init 6) and press Return. Information is written 
to the disk, all active processes are killed, and the system is brought to a power-down 
state. The system is then rebooted to the default level (usually multiuser). 

Shutting Down a System in a Hurry To shut down a system in a hurry, type 
u admin 2 0 and press Return. Information is written to the disk and the system is brought 
to power-down state, displaying the PROM prompt. 


Monitoring Processes 

The programs that are miming on a system at any one time are called processes. You can 
monitor the status of processes, control how much CPU time a process gets, and suspend 
or halt the execution of a process. 


H Commands for Monitoring Processes 

The ps (process status) command is your main tool for obtaining information about 
processes. You can use the ps command in combination with the grep command to focus 
your search for specific information. 

You can also use the dispadmin, priocntl, and nice commands to manage processes. 
Table 1-2 lists the commands for managing processes. 


Table 1-2 Commands for Managing Processes 


Command 

ps 

dispadmin 

priocntl 

nice 


Description 

Check the status of active processes on a system and display detailed Information about the 
processes. 

List default scheduling policies. 

Assign processes to a priority class and manage process priorities. 

Change the priority of a timesharing process. 
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Refer to the ps(lM), dispaclmin(lM), priocntl(lM), and nice(lM) manual pages for 
complete information about these commands. 

In addition, the /usr/proc/bin directory contains process tools that you can use to display 
highly detailed information about the processes listed in /proc. The /proc directory is also 
known as the process file system (proofs). It stores images of active processes by their 
process ID number. For more information about the / proc file system see “Types of File 
Systems” on page 145. 

The process tools are similar to some options of the ps command, except that the output 
provided by the tools is more detailed. In general, the process tools: 

■ Display more details about processes, such as f stat and f cntl information, working 
directories, and trees of parent and child processes 

■ Provide control over processes, enabling users to stop or resume them 
Table 1-3 summarizes the new /usr/proc/bin utilities. 


Table 1-3 

Command 

pstop pid 
prun pid 
ptime pid 
pwait pid 
pored pid 
pfiles pid 
pflags pid 

pidd pid 
pmap pid 
psig pid 
pstack pid 
ptree pid 
pwdx pid 


Process Tools in the /usr/proc/bin Directory 

Description 

Stop the process. 

Restart the process. 

Time the process using microstate accounting. 

Wait for the specified processes to terminate. 

Display credentiais. 

Display f stat and f cntl information for open files. 

Show /proc tracing flags, pending and held signals, and other status 
information for each Iwp. 

Show dynamic libraries linked Into each process. 

Show address map space. 

Display signal actions. 

Display hex+symbolic stack trace for each Iwp. 

Show process trees containing specified PIDs. 

Display current working directory. 


For a complete description of the process tools, refer to the proc(l) manual page. For 
information about how to use the process tools commands to display details about 
processes and start and stop them, see “Using the /usr/proc/bin Commands.” 
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The ps Command 

You can use the ps command to determine which processes are running (or not running) 
and get detailed information about an individual process, such as: 

■ PID (process ID) 

■ UID (user ID) 

■ Priority 

■ Control terminal 

■ Memory use 

■ CPU time 

■ Current status 

The ps command takes a snapshot of system activity at the time you type the command. If 
you are monitoring system activity by time, be aware that the results are already slightly 
out-of-date by the time you read them. Table 1^ shows the most frequently used options 
for the ps command. See the ps(l) manual page for a complete list of options. 


Table 1-4 Most Frequently Used Options for the ps Command 

Option Description 

-e Report on all processes. 

~f Show the owner of the process, by name instead of by UID, in the first column. This option 

turns off-1,-t,-s, and-r and turns on-a. 


-I 


Generate a long report, which includes all fields except STIME. 
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What the pa Command Reports 

When you type ps -e and press Return, you get a report that looks like this: 


oak%/usr/bin/ 
ps -e 


PID 

TTY 

TIME 

COMD 

0 

? 

0:02 

sched 

1 

? 

0:01 

Init 

2 

? 

0:00 

pageout 

192 

7 

0:00 

sac 

79 

9 

0:10 

inetd 

75 

? 

0:01 

in.route 

136 

7 

0:04 

automoun 

143 

7 

0:01 

cron 

123 

? 

0:01 

statd 

104 

? 

0:01 

rpcbind 

106 

7 

0:01 

rpc.rwal 

108 

? 

0:01 

rpc.Tuse 

110 

? 

0:01 

rpc.spra 

113 

? 

0:01 

ypblnd 

115 

? 

0:00 

keyserv 

117 

? 

0:01 

kerbd 

127 

7 

0:02 

lockd 

251 

pts/0 

0:00 

ps 

165 

? 

0:00 

sendmail 

193 

7 

0:01 

ttymon 

174 

7 

0:03 

syslogd 

156 

? 

0:01 

Ipsched 

209 

7 

0:02 

in.rlogi 

211 

pts/0 

0:03 

csh 

164 

9 

0:00 

IpNet 


oak% 


The columns are: 

■ PID: Process identification number. 

■ TTY: The terminal from which the process (or its parent) started. If the process has no 
controlling terminal, this column contains a question mark (?). Processes with question 
marks usually are system processes. 

■ time: The cumulative amount of CPU time used by the process. 

■ comd: The name of the command that generated the process. Note that for the ps - e 
command only the first eight characters of the file name are displayed. 

When you type ps -el and press Return, you get a listing that looks like this: 
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Table 1 

Field 

F 


oak% /usr/bin/ps -el 


F 

S 

UID 

PID 

PPID C 

PRI 

NI 

ADDR 

SZ 

WCHAN 

TTY 

TIME 

COMD 

19 

T 

0 

0 

0 80 

0 

SY 

f010f1c8 

0 


7 

0:02 

sched 

8 

S 

0 

1 

0251 

, 1 

20 

ff1ad800 

48 

ff1ad9c4 

? 

0;01 

init 

19 

S 

0 

2 

0 0 

0 

SY 

ff1ad000 

0 

ff1ad07d 

? 

0:00 

pageout 

8 

s 

0 

192 

1 49 

1 

20 

ff1f7000 

238 

ff2de348 

7 

0:00 

sac 

8 

s 

0 

79 

1 80 

1 

20 

ff232800 

291 

f010f1a4 

7 

0:10 

inetd 

8 

s 

0 

75 

1 80 

1 

20 

ff249000 

258 

f010f1a4 

? 

0:01 

in.route 

8 

s 

0 

136 

1 80 

1 

20 

ff2c3000 

327 

f0i0f1a4 

7 

0:04 

automoun 

8 

s 

0 

143 

1149 

1 

20 

ff293000 

287 

ff2de448 

? 

0:01 

cron 

8 

s 

0 

123 

1 80 

1 

20 

ff28e000 

270 

f010f1a4 

? 

0:01 

statd 

8 

s 

0 

104 

1 80 

1 

20 

ff25a000 

301 

f0l0fla4 

? 

0:01 

rpcbind 

8 

s 

0 

106 

1 77 

1 

20 

ff258800 

272 

f010f1a4 

? 

0:01 

rpc.rwal 

8 

s 

0 

108 

1 80 

1 

20 

ff260800 

272 

f010f1a4 

? 

0:01 

rpc.ruse 

8 

s 

0 

110 

1 78 

1 

20 

ff266800 

272 

f010f1a4 

? 

0:01 

rpc.spra 


(More information, not shown here) 


Table 1-5 describes the fields in the long listing report. 


>5 Summary of Fields in a pis -el Report 

Description 

Hexadecimal flags, which, added together, indicate the process’s current state, as follows; 

00 The process has terminated. Its place in the process table Is free. 

01 The process is a system process and is always In memory. 

02 The process is being traced by its parent. 

04 The process Is being traced by its parent and has been stopped. 

08 The process cannot be awakened by a signal. 

10 The process is currently in memory and is locked until an event completes. 

20 The process cannot be swapped. 

The current state of the process, as shown by one of the following letters: 

0 Currently running on the processor. 

S Sleeping; waiting for an I/O event to complete. 

R Ready to run. 

I Idle: process is being created. 

Z Zombie. The process has terminated and the parent is not waiting, but the dead process 

Is still in the process table. 

T Stopped because parent is tracing the process. 

X Waiting for more memory. 


UID 


The user ID of the owner of the process. 
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Table 1-^ Summary of Fields in a ps -el Report (continued) 

Field Description 

PID The process identification number. 

PPID The parent process’s identification number. 

C The process's CPU use (that is, an estimate of the percentage of CPU time used by the process). 

PRI The process’s scheduling priority. Higher numbers mean lower priority. 

NI The process’s nice number, which contributes to its scheduling priority. Making a process “nicer" 

means lowering Its priority so it does not use up as much CPU time. 

SZ The amount of virtual memory required by the process. This is a good indication of the demand the 

process puts on system memory. 

TTY The terminal from which the process (or its parent) started, or a question mark to indicate there is no 
controlling terminal (which usually indicates a system process). 

TIME The total amount of CPU time used by the process since it began. 

COMD The command that generated the process. 


Using the ps Report 

When you need to check on which processes or daemons are running, use the ps -e 

option. If you need more detailed information about a process, use the ps -el options. 

See the ps(l) manual page for a complete list of options. With experience, you will know 

how the report should look and be able to to judge what is out of the ordinary. 

Here are some guidelines on how to spot potential problems: 

■ Look for many identical jobs owned by the same user. This may result from someone 
running a script that starts a lot of background jobs without waiting for any of the jobs 
to terminate. Talk to the user to find out if thaf s the case. If necessary, use the kill 
command to terminate some of the processes. See the following section for more 
information on killing a process. 

■ Look at the TIME field for processes that have accumulated a large amount of CPU 
time. Such processes might be in an endless loop. 

■ Look at the C field to find unimportant processes that consume a large percentage of 
CPU time. If you do not think a process warrants so much attention, use the priocnti 
command to lower its priority. See the priocntl(lM) manual page for more 
information. 

■ Look at the SZ field for processes that consume too large a percentage of memory. If a 
process is a memory hog, kill the process. If many processes are using lots of memory, 
the system may need more memory. 
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■ Watch for a runaway process that uses progressively more CPU time. You can check 
this by using the -f option to see the start time (stime) of the process and by watching 
the TIME field for the accumulation of CPU time. 


Killing Processes 

Sometimes you need to eliminate a process entirely. Use the kill command to do this. The 
syntax of the kill command is kill - signal pxd, where signal is a number or a name. 

CAUTION! Kill a process only if you cannot get it to quit in the usual way. 

Sometimes processes do not die when you use the kill command. The three most 
common cases are; 

■ The process is waiting for a device, such as a tape drive, to complete an operation 
before exiting. 

■ The process is waiting for resources that are unavailable because of NFS problems. To 
kill such a process, type kill -QUIT PID. 

m The process is a zombie, as shown by the message defunct in the ps report. A zombie 
process is one that has had all its resources freed, but has not received an 
acknowledgment from a parent process, receipt of which would ordinarily remove its 
entry from the process table. The next time a system is booted, zombie processes are 
cleared. Zombies do not affect system performance, and you do not need to remove 
them. 

To kill a process: 

1. Become superuser. You must be superuser to kill a process that you do not own. 

2. Type ps -e and press Return. A list of the processes is displayed. Use the PID 

(process ID) number in the first column as input to the next step. If you know which 
process is causing the problem, you can type ps -e i grep and press 

Return to focus your search, 

3. Type kill PID and press Return. When you type kill with no arguments, signal 15 
is sont. 

4. Type ps -e and press Return, Check to see if the process has terminated. If it’s still 
there, go to step 5. 

5. Type kill -9 PID and press Return. The process should be terminated. Type man 
-s5 signal and press Return to see a description of the signals used by kill. 

For example, if Open Windows is frozen on the system oak, you must log in remotely and 
kill the process from another system: 

elni% rlogin oak 
Password: 

oak% ps -e j grep openwin 
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PID TTY TIME COMD 

2212 pts/0 0:00 openwin 

2213 pts/1 0:00 grep openwin 
oak% su 

Password: 
oak# kill 2212 
oak# exit 
oak% logout 
elm% 


Using the /usr/proc/bin Commands 

The Solaris 2.6 release provides you with a set of commands that you can use to display 
detailed, technical information about active processes. These commands are summarized 
in Table 1-6. 


Process Tools in the /usr/proc/bin Directory 

Description 

Stop the process. 

Restart the process. 

Time the process using microstate accounting. 

Wait for specified processes to terminate. 

Display credentials. 

Display f stat and f cntl information for open files. 

Show /proc tracing flags, pending and held signals, and other status 
information for each Iwp. 

Show dynamic libraries linked into each process. 

Show address map space. 

Display signal actions. 

Display hex+symbolic stack trace for each Iwp. 

Show process trees containing specified PIDs. 

Display current working directory. 

♦Must be superuser to execute. 

NOTE. If you use the /usr/proc/bin commands frequently, add the process tool direc¬ 
tory to your PATH variable to make the commands more easily accessible. 

All of the /usr/bin/proc commands use the process ID (PID) as the argument to the 
command. You can obtain the PID by using the ps -e and the gr'ep commands to search 


Table 1-6 

Command 

pstop pid 
prun pid 
ptitne pid 
pwait pid 
pcred pid* 
pfiles pid* 
pflags pid* 

pldd pid* 
pmap pid* 
psig pid* 
pstack pid* 
ptree pid 
pwdx pid* 
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for the name of ±e process you want more information about. The following example 
displays the PID for the openwin process in the first column: 

oak% ps -e I 
PID TTY 

2212 pts/0 

2213 pts/1 
oak% 

Displaying and Controlling Information About Processes 

Follow these steps to display and control information about a process: 

1. Type ps -e 1 grep process-name and press Return, The first column of the output 
displays the PID for the appropriate process name. 

2. Become superuser to use pored, pf lies, pflags, pldd, pmap, psig, pstack, and pwdx 
commands. 

3. Type pcoamand PID and press Return. The information for the specified command is 
displayed. 

The following examples show the output for each of the /usr/proc/bin commands for the 
dtlogin PID of 283: 

castle% ps -e j grep dtlogin 
283 ? 0:00 dtlogin 

270 ? 0:01 dtlogin 

castle% 

# /usr/proc/bin/pcred 283 

283: e/r/suid=0 e/r/sgid=0 

groups: 1023456789 12 

# exit 

castle% /usr/proc/bin/ptime 283 
/ptime: exec failed 

real 0.016 

user 0.000 

sys 0.016 

castle% 

# /usr/proc/bin/pfiles 283 

283: /usr/dt/bin/dtlogin -daemon 

Current rlimit: 64 file descriptors 
0: S_IFDIR mode:0755 dev:32,24 ino:2 uid:0 gid:0 si2e:1024 
0_RD0NLYI0_LARGEFILE 

1: S_IFDIR inode:0755 dev:32,24 ino:2 uid;0 gid:0 size:1024 
0_RD0NLYI0_LARGEFILE 

2: S_IFREG mode:0644 dev:32,24 ino:326220 uid:0 gid:0 size:49 
0_WR0NLY]0_APPENDI0_LARGEFILE 

3: S_IFCHR mode:0666 dev:32,24 ino:406038 uid:0 gid:3 rdev:13,12 
0_RDWR 

4: S_IFIF0 mode:0666 dev:171,0 ino:4124779288 uid:0 gad:0 size:0 
O^RDWR10_N0NBL0CK 

5: S_IFREG mode:0644 dev:32,24 ino:326221 uid:0 gid:0 size:4 
0_WR0NLY10_LARGEFILE 


grep openwin 
TIME COMD 
0:00 openwin 
0:00 grep openwin 







28 


iNTRODUCINC SOLARIS SYSTEM ADMINISTRATION 
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i 

I 

i 


advisory write lock set by process 270 
7: S_IFS0CK niode:0666 dev:166,0 ino:32032 uid :0 gid :0 size :0 
0_RDWR 

8 : S_IFD00R niode:0444 dev:l71,0 ino:4124780632 uid:0 gid:0 size:0 
0_RD0NLY[0_LARGEFILE FD__CLOEXEC door to nscd[174] 

# 

# /usr/proc/bin/pflags 283 

283: /usr/dt/bin/dtlogin -daemon 

/I: flags = PR_PCINVAL|PR_ORPHANlPR_ASLEEP [ wait() ] 

# 

# /usr/proc/bin/pldd 283 

283: /usr/dt/bin/dtlogin -daemon 

/usr/openwin/lib/libXniu.so .4 
/usr/openwin/lib/libXI1.so.4 
/usr/dt/lib/libDtSvc.so .1 
/usr/lib/libresolv.so .2 
/usr/lib/libdl.so .1 
/usr/lib/libbsm.so .1 
/usr/lib/libauth.so .1 
/usr/lib/libsocket.so .1 
/usr/lib/libnsl.so ,1 
/usr/dt/lib/libSptFwa.so.1 
/usr/lib/libc.so .1 
/usr/openwin/lib/libXt.so.4 
/usr/openwin/lib/libSM.so .6 
/usr/openwin/lib/liblCE.S 0.6 
/usr/openwin/lib/libXext.so.0 
/usr/lib/libm.so .1 
/usr/openwin/lib/libtt.so .2 
/usr/dt/lib/libXm.so.3 
/usr/lib/libmp.so .2 
/usr/lib/nss_files.so .1 
/usr/lib/libpam.so. 1 

# 

# /usr/proc/bin/pmap 283 

283: /usr/dt/bin/dtlogin -daemon 


00010000 

108K 

read/exec 

/usr/dt/bin/dtlogin 

O0O3AO00 

32K 

read/write/exec 

/usr/dt/bin/dtlogin 

00042000 

80K 

read/write/exec 

[ heap ] 

EEEg0000 

12K 

read/shared 

dev:32,24 ino;196384 

EEEA0000 

12K 

read/shared 

dev:32,24 ino:196384 

EEEBO000 

12 K 

read/shared 

dev:32,24 ino:196384 

EEEC000O 

8 K 

read/write 

[ anon ] 

EEF11000 

4K 

read/write 

[ anon ] 

EEF89000 

4K 

read/write 

[ anon ] 

EF001000 

4K 

read/write 

[ anon ] 

EF060O00 

24K 

read/exec 

/usr/lib/libpam.so .1 

EF075000 

4K 

read/write/exec 

/usr/lib/libpam.so .1 

(More information, not shown here) 


EF7C0000 

4K 

read/exec/shared 

/usr/lib/libdl.so .1 

EF7D0000 

112K 

read/exec 

/usr/lib/ld.so. 1 

EF7FB000 

8 K 

read/write/exec 

/usr/lib/ld.so .1 

EF7FD000 

4K 

read/write/exec 

[ anon ] 

EFFF9000 

total 

28K 

5480K 

read/write/exec 

[ stack ] 


# 
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# /usr/proc/bin/psig 283 

283: /usr/dt/bin/dtlogin -daemon 

HUP ignored 

INT caught RESETHAND.NODEFER 

QUIT ignored 

ILL default 

TRAP default 

ABRT default 

EMT default 

FPE default 

KILL default 

BUS default 

SEGV default 

SYS default 

PIPE ignored 

ALRM default 

TERM caught RESETHAND.NODEFER 

USR1 caught RESETHAND.NODEFER 

USR2 default 

CLD default NOCLDSTOP 

PWR default 

WINCH default 

URG default 

POLL default 

STOP default 

TSTP default 

CONt default 

TTIN ignored 

TTOU default 

VTALRM default 

PROF default 

XCPU ignored 

XFSZ ignored 

WAITING default 

LWP default 

FREEZE default 

THAW default 

CANCEL default 

LOST default 

RTMIN default 

RTMIN+1 default 

RTMIN+2 default 

RTMlN+3 default 

RTMAX-3 default 

RTMAX-2 default 

RTMAX-I default 

RTMAX default 

# 

# /usr/proc/bin/pstack 283 

283: /usr/dt/bin/dtlogin -daemon 

ef479154 wait 0 

ef479154 _libc_wait (0, 3ec4c, 3b000, 12d, ef4e227c, 1e340) + 8 
0001e340 ManageSession (43000, 43000, 482f8, ef001230, 81010100, c) + 454 
00019348 StartDiSplay (4a2f8, 3c954, 43000, 3b224, ef001240, ff00) + 7bc 
0001a324 ForEachDisplay (189a8, 0, 2400, 41800, 42e48, 17ca8) + 1c 
00017d54 main (0, effffefc, efffff08, 3b000, 0, 0) + 228 
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0001541c _start (0, 0, 0, 0, 0 , 0 ) + dc 

# 

# /usr/proc/bin/pwdx 283 

283: / 

# 

castle% /psr/proc/ptime 283 

real 0,066 

user 0.000 

sys 0.032 

castle% 

castle% ptree 283 
270 /usr/dt/bin/dtlogin -daemon 
283 /usr/dt/bin/dtlogin -daemon 
301 /bin/ksh /usr/dt/bin/Xsession 
311 /usr/openwin/bin/fbconsole 

346 /usr/dt/bin/sdt_shell -c unsetenv _ PWD; unsetenv DT; 

349 -csh -c unsetenv _ PWD; unsetenv DT; setenv DISP 

366 /usr/dt/bin/dtsession 

373 dtwm 

374 dtterm -session dt0vPl0t -sdtserver 
387 /bin/csh 

407 ./textedit 
528 sh 

390 /bin/csh 
393 /bin/csh 

417 /usr/openwin/bin/cmdtool 
420 /bin/csh 
531 /bin/csh 
553 ptree 283 

375 dtfile -session dtbfiQD_ 

405 dtfile -session dtbfiQD_ 

376 snapshot -Wp 781 588 -Ws 326 201 -WP 6 6 +Wi -f snapshot.rs 

castle% 



The Priority Control Command (priocnti) 

You can use the priocntl command to display or set scheduling parameters of specified 
processes. You can also use it to display the current configuration information for the 
process scheduler of a system or to execute a command with specified scheduling 
parameters. 


Each process has a distinct class with a separate scheduling policy assigned to each class. 
The possible classes that are configured on your system are: 

■ System (SYS) 

■ Interactive (lA) 


■ Real-time (RT) 

■ Timesharing (TS) 
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For the timesharing class the user-supplied priority ranges from -20 to -t-20. The priority of 
a timeshare process, referred to as the user-mode priority, is inherited from the parent 
process. The system looks up the user-mode priority in its timesharing dispatch parameter 
table and adds in any nice or priocnti (user-supplied) priority and ensures a 0-59 range 
to create a global priority. 

In the default configuration, a runnable real-time process runs before any other process. 
Inappropriate use of real-time processes can have a dramatic negative impact on system 
performance. 

Displaying Basic Information About Process Ciasses 

Follow this procedure to display basic information about process classes: 

n Type priocnti -1 and press Return. The process class and scheduling parameters for 
the system are displayed. 

In this example, all classes are defined: 

castle% priocnti -I 
CONFIGURED CLASSES 


SYS (System Class) 

TS (Time Sharing) 

Configured TS User Priority Range: -60 through 60 
lA (Interactive) 

Configured lA User Priority Range: -60 through 60 
RT (Real Time) 

Maximum Configured RT Priority: 59 

castle% 

Displaying the Giobai Priority of a Process 

You can use the ps -eel command to display the global priority of a process. The global 
priority is listed under the PRi column. 

The following example shows the output from the ps - eel command. Data in the PRi 
column shows that pageout has the highest priority at 98, and powerd has the lowest at 16: 

castle% ps -eel 


F 

S 

UID 

PID 

PPID 

CLS 

PRI 

ADDR 

SZ 

WCHAN 

TTY 

TIME 

CMD 

19 

T 

0 

0 

0 

SYS 

96 

f0274e38 

0 


? 

0:01 

sched 

8 

S 

0 

1 

0 

TS 

58 

f5b2d888 

162 

f5b2da80 

? 

0:00 

in it 

19 

S 

0 

2 

0 

SYS 

98 

f5b2d1c8 

0 

f02886a4 

? 

0:00 

pageout 

19 

s 

0 

3 

0 

SYS 

60 

f5b2cb08 

0 

f028aeb4 

? 

0:11 

fsflush 

8 

s 

0 

205 

1 

TS 

58 

f5b2b6G8 

448 

f5d47b26 

7 

0:00 

sendmail 

8 

s 

0 

91 

1 

TS 

58 

f5d10890 

340 

f597e07e 

7 

0:00 

in.route 

8 

S 

0 

277 

1 

TS 

58 

f5b2b008 

350 

f591ac78 

? 

0:00 

sac 

8 

s 

0 

101 

1 

TS 

58 

f5b2bd88 

445 

f597e02e 

7 

0:00 

rpebind 

8 

S 

0 

174 

1 

TS 

52 

f5b2c448 

480 

f5b2c640 

7 

0:00 

nsed 

8 

s 

0 

128 

1 

TS 

42 

f5d101d0 

446 

f5d47f86 

7 

0:00 

inetd 
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8 

S 

0 

103 

1 

TS 

20 

fSdOfblO 

462 

f5d47fae 

? 

0:00 keyserv 

8 

S 

0 

150 

1 

TS 

58 

f5d0f450 

558 

f5d47d7e 

? 

0:00 automoun 

8 

S 

0 

133 

1 

TS 

53 

f5d0ed90 

502 

f5d47f5e 

9 

0:00 statd 

8 

S 

0 

135 

1 

TS 

33 

f5d0e6d0 

409 

f5d47ee6 

? 

0:00 lockd 

8 

S 

0 

280 

257 

TS 

48 

f5d0e010 

380 

f5cc5706 

? 

0:00 mibiisa 

8 

S 

0 

154 

1 

TS 

32 

f5dea898 

697 

f5d47d56 

9 

0:00 syslogd 

8 

S 

0 

168 

1 

TS 

48 

fSdealdS 

360 

f591aeb8 

? 

0:00 cron 

8 

S 

0 

184 

1 

TS 

53 

f5de9b18 

648 

f5d47c66 

? 

0:00 Ipsched 

8 

S 

0 

285 

1 

lA 

59 

f5de9458 

471 

f5d47716 

? 

0:00 fbconsol 

8 

S 

0 

227 

1 

TS 

52 

f5de8d98 

518 

f5d479be 

? 

0:01 void 

8 

S 

0 

202 

1 

TS 

16 

f5de86d8 

215 

f5de88d0 

? 

0:00 powerd 

8 

s 

d 

215 

1 

TS 

59 

f5de8018 

214 

f5d47b4e 

? 

0:00 utmpd 

8 

s 

1001 

282 

270 

lA 

59 

f5e4c8a0 

2360 

f5d47806 

? 

0:34 Xsun 

3 

S 

0 

278 

1 

TS 

38 

f5e4a6e0 

368 

f5d4782e 

console 

0:00 ttymon 

8 

s 

0 

257 

1 

TS 

58 

f5e4a020 

444 

f5d4791e 

9 

0:00 snmpdx 

8 

s 

0 

268 

1 

TS 

58 

f5e6e8a8 

738 

f5eaf1f6 

? 

0:00 snmpXdmi 

8 

S 

0 

283 

270 

lA 

59 

f5e4bb20 

1370 

f5e4bb90 

9 

0:00 dtlogin 

8 

s 

0 

266 

1 

TS 

58 

f5e4b460 

591 

f5d478f6 

? 

0:00 dmispd 

8 

S 

0 

270 

1 

TS 

48 

f5e4ada0 

1344 

f597e6e6 

9 

0:01 dtlogin 

8 

s 

0 

281 

277 

TS 

58 

f5e4c1e0 

371 

f5e4c3d8 

? 

0:00 ttymon 

8 

s 

1001 

311 

301 

lA 

59 

f5e6e1e8 

471 

f5d476ee 

9 

0:00 fbconsol 

8 

S 

1001 

301 

283 

lA 

59 

f5e6db28 

392 

f5e6db98 

? 

0:01 Xsession 

8 

s 

1001 

349 

346 

lA 

59 

f5e6d468 

256 

f5e6d660 pts/2 

0:00 csh 

8 

S 

1001 

315 

1 

lA 

59 

f5e6cda8 

982 

f5d476c6 

? 

0:00 speckeys 

8 

S 

1001 

366 

349 

lA 

42 

f5e6c6e8 

1410 

f5d47586 

pts/2 

0:01 dtsessio 

8 

S 

1001 

374 

366 

lA 

59 

f5e6c028 

1655 

f5d474be 

?? 

0:16 dtterm 

8 

S 

1001 

346 

301 

lA 

59 

f5ef38b0 

1211 

f5d47676 pts/2 

0:00 sdt_shel 

8 

s 

1001 

347 

1 

lA 

59 

f5ef31f0 

478 

f5d47626 

? 

0:00 dsdm 

8 

s 

0 

367 

128 

TS 

32 

f5ef2b30 

676 

f5d475ae 

? 

0:00 rpc.ttdb 

8 

s 

1001 

365 

1 

lA 

59 

f5ef2470 

903 

f5d475d6 pts/2 

0:01 ttsessio 

8 

s 

1001 

375 

366 

lA 

49 

f5ef1db0 

1702 

f5d474e6 

? 

0:03 dtfile 

8 

S 

1001 

376 

366 

lA 

48 

f5ef16f0 

1118 

f5d4750e 

? 

0:01 snapshot 

8 

s 

1001 

373 

366 

lA 

59 

f5ef1030 

1710 

f5d4755e 

? 

0:04 dtwm 

8 

s 

1001 

393 

374 

lA 

43 

f5f468b8 

253 

f5f93386 pts/5 

0:00 csh 

8 

s 

1001 

378 

1 

lA 

59 

f5f461f8 

385 

f5f46268 

? 

0:00 sdtvolch 

8 

s 

1001 

405 

375 

lA 

59 

f5f45b38 

1687 

f5f76738 

? 

0:00 dtfile 

8 

s 

1001 

445 

378 

lA 

55 

f5f45478 

193 

f591aaf8 

7 

0:00 cat 

8 

s 

1001 

387 

374 

lA 

59 

f5f44db8 

255 

f5f44fb0 pts/3 

0:00 csh 

8 

s 

1001 

407 , 

387 

I 

48 

f5f446f8 

1140 f5d4732e ptS/3 

0:02 textedit 

8 

s 

1001 

390 

374 

lA 

55 

f5f44038 

252 

f5f93986 

ptS/4 

0:00 csh 

8 

s 

1001 

417 

393 

lA 

48 

f5fa58c0 

916 

f5d472de 

ptS/5 

0:01 cmdtool 

8 

s 

1001 

420 

417 

lA 

48 

f5fa5200 

252 

f5fc2b96 pts/6 

0:00 csh 

8 

s 

1001 

531 

374 

I 

49 

f5fa4480 

256 

f5fa4678 

pts/7 

0:00 csh 

8 

0 

0 

56 

531 

lA 

29 

f5fa3dc0 

199 


pts/7 

0:00 ps 

8 

s 

0 

528 

387 

lA 

58 

f5fa3040 

69 

f5f8427e 

pts/3 

0:00 sh 


castle% 

You can also use the /usr/sbin/dispadmin -1 command to display process scheduler 
information. 

The following example shows the output from the d is p lad min - 1 command: 

castle% /usr/sbin/dispadmin -1 
CONFIGURED CLASSES 
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SYS (System Class) 

TS (Time Sharing) 

lA (Interactive) 

castle% 

For complete information, refer to the dispadmin(lM) manual page. 

Designating a Process Priority 

Follow these steps to designate a process priority: 

1. Become superuser. 

2. Type priocntl -e -c class -m user’limit -p priority command-name 

Return. The - e option executes the command, the - c class option specifies the class. 
Default classes are ts (timesharing) or rt (real-time). The -m user-limit option 
specifies the maximum amount you can raise or lower your priority with the - p 
option. The -p priority command-name option enables you to specify the relative 
priority, in the RT class for a real-time thread. For a timesharing process, the -p 
option enables you to specify the user-supplied priority, which ranges from -20 to 
+20. 

3. While the process is running, in another shell, type ps -eel | command-name 

and press Return. 

4. Review the output of the PRi column to verify that you have changed the process 
status successfully. 

The following example starts the find command with the highest possible user-supplied 
priority: 

castle% priocntl -e -c TS -m 20 -p 20 find / -name core -print 
castle% ps -eel 1 grep find 

8 S 0 632 528 TS 60 f5fa4b40 200 f5ff7ba0 pts/3 0:03 find 

castle% 

Changing the Scheduling Parameters of a Timeshare Process 

Follow these steps to schedule the parameters of a timeshare process: 

1. Become superuser. 

2. Type priocntl -s -m user-limit [-p priority] -i id-type and press 

Return. The - s option enables you to set the upper limit on the user priority range 
and change the current priority. The -m user-limit option specifies the maximum 
amount you can raise or lower your priority with the -p option. The -p priority 
command-name option enables you to designate a priority. The -i id-type and 
id-list option uses a combination of id-type and id-list to identify the process. 
The id-type specifies the type of ID, such as PID or UID. 

3. Typeps -eel | grep and press Return. 
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4. Review the output of the PRI column to verify that you have changed the process 
status successfully. 

The following example executes a command with a 500-millisecond time slice, a priority 
of 20 in the rt class, and a global priority of 120: 

oak% priocntl -s -c RT -t 500 -p 20 myprog 
oak% ps -eel } grep myprog 

Changing the Class of a Process 

Follow these steps to change the class of a process: 

NOTE. You must be superuser or working in a real-time shell to change the class of a 
process from or to real-time. 

1. Become superuser. 

2. Type priocntl -s -c class and press Return. The -s option 

enables you to set the upper limit on the user priority range and change the current 
priority. The -c class option specifies the class, TS or RT, to which you are changing 
the process. The -i id-type and id-list options uses a combination of id-type and 
id-list to identify the process. The id-type specifies the type of ID, such as PID or 
UID. 

3. Type ps -eel 1 grep and press Return. 

4. Review the output of the PRI colunm to verilfy fiiat you have changed the process 
status successfully. 

The following example changes all the processes belonging to user 1001 to real-time 
processes: 

# priocntl -s -c RT -i uid 1001 


# ps 

8 S 

-eel 1 
1001 

grep 

282 

1001 

270 

RT 

100 

f5e4c8a0 

2392 

f5d47806 

? 

0:48 

Xsun 

8 

S 

1001 

311 

301 

RT 

100 

f5e6e1e8 

471 

f5d476ee 

7 

0:00 

fbconsol 

8 

s 

1001 

301 

283 

RT 

100 

f5e6db28 

392 

f5e6db98 

7 

0:01 

Xsession 

8 

s 

1001 

349 

346 

RT 

100 

f5e6d468 

256 

f5e6d660 

pts/2 

0:00 

esh 

8 

s 

1001 

315 

1 

RT 

100 

f5e6cda8 

982 

f5d476c6 

7 

0:00 

speckeys 

8 

s 

1001 

366 

349 

RT 

100 

f5e6c6e8 

1410 

f5d47586 

pts/2 

0:01 

dtsessio 

8 

s 

1001 

374 

366 

RT 

100 

f5e6c028 

1814 

f5d474be 

?? 

0:24 

dtterm 

8 

s 

1001 

346 

301 

RT 

100 

f5ef38b0 

1211 

f5d47676 

pts/2 

0:00 

sdt_shel 

8 

s 

1001 

347 

1 

RT 

100 

f5ef31f0 

478 

f5d47626 

? 

0:00 

dsdm 

8 

s 

1001 

365 

1 

RT 

100 

f5ef2470 

903 

f5d475d6 

pts/2 

0:01 

ttsessio 

8 

s 

1001 

375 

366 

RT 

100 

f5ef1db0 

1702 

f5d474e6 

? 

0:03 

dtfile 

8 

s 

1001 

376 

366 

RT 

100 

f5ef16f0 

1118 

f5d4750e 

? 

0:01 

snapshot 

8 

s 

1001 

373 

366 

RT 

100 

f5ef1030 

1710 

f5d4755e 

7 

0:06 

dtwm 

8 

s 

1001 

393 

374 

RT 

100 

f5f468b8 

253 

f5f93386 

pts/5 

0:00 

esh 

8 

s 

1001 

378 

1 

RT 

100 

f5f461f8 

385 

f5f46268 

? 

0:00 

sdtvolch 

8 

s 

1001 

405 

375 

RT 

100 

f5f45b38 

1687 

f5f76738 

7 

0:00 

dtfile 

8 

s 

1001 

445 

378 

RT 

100 

f5f45478 

193 

f591aaf8 

7 

0:00 

cat 

8 

s 

1001 

387 

374 

RT 

100 

f5f44db8 

255 

f5f44fb0 

ptS/3 

0:00 

esh 

8 

s 

1001 

407 

387 

RT 

100 

f5f446f8 

1140 

f5d4732e 

pts/3 

0:03 

textedit 
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8 

S 

1001 

390 

374 

RT 

100 

f5f44038 

252 

f5f93986 

pts/4 

0:00 

csh 

8 

S 

1001 

417 

393 

RT 

100 

f5fa58c0 

916 

f5d472de 

ptS/5 

0:01 

cmdtool 

8 

S 

1001 

420 

417 

RT 

100 

f5fa5200 

252 

f5fc2b96 

pts/6 

0:00 

csh 

8 

S 

1001 

531 

374 

RT 

100 

f5fa4480 

256 

f5ff62a6 

pts/7 

0:00 

csh 

8 

S 

1001 

634 

374 

RT 

100 

f5fa3dc0 

252 

f5ff68a6 

ptS/8 

0:00 

csh 


# 

Changing the Priority of a Process {nice) 

You can use the nice command to raise or lower the priority of a command or a process. 
When you use the nice command without an argument, the default is to increase the nice 
number by four units, thus lowering the priority of the process. 

NOTE. You must be superuser to change the priority of a process by using the nice com¬ 
mand. 

Use the following command to lower the priority of a conunand by four units (the default): 
/usr/bin/nice command-name 

Use the following command to lower the priority of a command by increasing the nice 
number by ten units: 

/usr/bin/nice +10 command-name 


NOTE. The plus sign (+) is optional for positive numbers. The minus sign (-) is required 
for negative numbers. 

Use the following command to raise the priority of a command by lowering the nice 
number by 10 units; 

/usr/bin/nice -10 command-name 

Use the following command to raise the priority of a command by lowering the nice 
number by 10 units. The first minus sign is the option sign, and the second minus sign 
indicates a negative number: 

/usr/bin/nice - -10 command-name 

Troubleshooting Processes 

The following list provides some tips for troubleshooting problems with processes: 

■ Look for several identical jobs owned by the same user. This situation may result from 
running a script that starts a lot of background jobs without waiting for any of the jobs 
to finish. 

■ Look for a process that has accumulated a large amount of CPU time in the time field. 
The process may be in an endless loop. 
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■ Look for a process running with a priority that is too high. Type -s -c to display the 
CLS field with the scheduler class of each process. A process executing as a real-time 
(rt) process can monopolize the CPU. Alternatively, look for a timeshare (ts) process 
with a high nice value. A user with superuser privileges may have bumped up the 
priorities of this process. You can lower the priority by using the nice command. 

■ Look for a runaway process—one that progressively uses more and more CPU time. 
You can monitor the process by looking at the time when the process started (STIME) 
and by watching the accumulation of CPU time (time) for a while. 


Reviewing Essentiai Administration Toois 

The SunOS 5.x system software provides you with three kinds of administration tools: 

■ The usual collection of operating system commands. 

■ An administration tool (Admintool) with a graphical user interface. 

■ The unbundled Solstice AdminSuite with a graphical user interface. For an 
introduction to the Solstice AdminSuite, see “Introducing the Solstice AdminSuite 
Product." 


Frequently Used Commands 

The following sections briefly introduce basic SunOS 5.x commands that you are likely to 
use regularly as part of routine system administration; they are grouped by tasks. See 
“Basic OS Commands" in Chapter 2 for more frequently used commands. See Appendix 
A for a list of SunOS A.x commands and their SunOS 5.x equivalents. 

Getting Around in the RIe System 

SunOS 5.x system software has a hierarchical file system. When administering systems, 
you need to know where you are in the file hierarchy and how to change to a different 
directory. 

Finding Where You Are in the RIe System To find out where you are in the file 
system hierarchy, type pwd and press Return. The print working directory command dis¬ 
plays the current directory. 

oak& pwd 

/etc 

oak% 

Changing Directories To change directories, type cd pathname and press Return. The 
change directory command puts you in the directory name you type: 

oak% cd /usr 
oak% pwd 
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/usr 

oak% 

If you type cd and press Return without typing a path name, you are returned to the login 
home directory. 

Finding information About Files 

Using the is command, you can list the contents of a directory and display permissions, 
links, ownership, group, size (in bytes), modification date and time, and file name for 
files. Many user problems related to accessing files can be traced to problems with 
incorrect permissions or ownership. See Chapter 10, “Recognizing File Access 
Problems,” for more information. 

Displaying File Information 

To display information about an individual file, type Is -1 filename and press Return. 
Permissions, links, owner, group, file size in bytes, modification date and time, and the 
file name are displayed: 

oak% Is -1 /etc/passwd 

-r--r--r-- 1 root sys 659 Feb 24 17:28 /etc/passwd 

oak% 

To see a complete list for all the files in the directory, type Is -1 and press Return. See the 
Is manual page for a complete list of options. 

Finding a File 

To find a file by searching from the home directory, type find $H0ME -name filename 
-print and press Return. The $home variable starts the search with the home directory. 

The -name option looks for the name specified in the filename variable. The -print option 
displays the results of the find. If the named file is not found, the prompt is redisplayed. 

This example shows the results of a find looking for core files: 

oak% find $HOME -name core -print 

/home/ignatz/core 

oak% 
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Table 1-7 shows some of the options to the find command that you can use to focus your 
searches. 


Table 1-7 

Option 

-fstype type 
-prune 
-nouser 
-nogroup 
-atime n 
-mtime n 
-ctiine n 

-Xdev 


Options to the ffnd Command 

Description 

Finds files of the file system type you specify (typically uf s or nf s). 

Limits the search to the specified directory. 

Finds files that belong to a user not in the /etc/passwd database. 

Finds files that belong to a group not in the /etc/group database. 

Rnds files that have been accessed within the last n days. 

Finds files that have been modified within the last n days. 

Rnds files that have been changed within the last n days. Changes can include changing 
its attribute such as the number of links, its owner, or its group. 

Restrict search to one file system. 


See the find(l) manual page for a complete list of options. 

Finding the Type of a File 

Sometimes you need to determine the type of a file. To find the type of a file, type Tile 
flleaaae and press Return. The output of the command makes an educated guess about 
the type of the file. 

For example, if a user is trying to execute an ASCII file that does not have execute 
permissions, or execute an empty file, displaying the file type will tell you whether the 
system recognizes the file as a command. 

In this example, the file is empty: 

anastasia% file junk 
junk: empty file 
anastasia% 

In this example, the file is an ASCII text file; 

anastasia% file junk 
junk: ascii text 
anastasia% 

In this example, the file is a text file with executable permissions, so the file command 
reports that the file contains commands and is text: 

anastasia% chmod 777 junk 
anastasia% file junk 
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junk: commands text 
anastasia% 

NOTE. You can, of course, determine if the command has execute permissions using the 
Is -1 command. 

To show the file type for all files in a directory, type file * and press Return. The files are 
listed in alphabetical order followed by the file type: 

$ file * 


coterie: 

course: 

dead.letter 

ksyms 

people: 

personal: 

showrev: 

status: 

text: 

todo: 

$ 


directory 
ascii text 
ascii text 
English text 
directory 
directory 
ascii text 
directory 
directory 
ascii text 


Finding Information In Files 

You can use the grep and eg rep commands to search files and command output for 
specific information. 

Searching Flies for Text Strings To search files for a specific text string, type grep 
search-string filenames and press Return. Lines in the files containing the string are 
displayed. 

In this example, the passwd file is searched for lines containing csh: 
oak% grep csh /etc/passwd 

ignatz::6693:10:Iggy Ignatz 64607:/home/ignatz:/bin/csh 

fred::14072:10:Fred Lux:/home/fred:/bin/csh 

oak% 

You can search more than one file by specifying a series of file names separated by spaces, 
or by using metacharacters such as the asterisk (*) or question mark (?) together with (or 
in place of) the file name. 

To print out lines that do not contain the specified string, type grep -v search-string 
filename and press Return. Lines in the file that do not contain the string are displayed. 

Searching Input for Lines with a Given Pattern You can use the grep command 
with pipes in combination with many administrative commands. For example, if you want 
to find all of a user’s current processes, pipe the output of the ps command to grep and 
search for the user name, type ps -e | grep m/w, and press Return. The listing for the 
name you specify is displayed. 

For example, to find the OpenWindows process: 
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oak% ps -e grep openwin 
PID TTY TIME COMD 

2212 pts/0 0:00 openwin 
oak% 

Looking at Files 

You will undoubtedly spend lots of time looking at the content of files. When you need to 
look at the entire file, use the more command. When the information you need is at the end 
of the file (for example, in a log file), use the tail command to display the last 10 lines of 
the file. When important information is at the beginning of the file, use the head command 
to display the first 10 lines of the file. 

Viewing a File 

To view a file, type more filename and press Return. The file is displayed one screen at a 
time. Press the Spacebar to view the next screen. 

To search for a specific string in a file you are viewing with more, type / search-string 
and press Return. The text scrolls to display the place in the file that contains the text 
you type as the search-string variable and displays the search string and the message 
. . . skipping at the top of the window. If there is no match, the message Pattern not 
found is displayed at the bottom of the window and the text does not scroll. 

For example, to find the words Local aliases in the /etc /mail /aliases file, type / Local 
aliases and press Return: 

/Local aliases 
...skipping 

####################### 

# Local aliases below # 

####################### 

NOTE. You must use exact capitalization in the search string for the more command. If 
you type / local aliases in the previous example, the pattern is not found. 

To search for the next occurrence of the search string, type n. To quit more, type q. The 
shell prompt is redisplayed. 

Another way to quit more, if Control-C is set as your shell kill character, is to press 
Control-C. The shell prompt is redisplayed. 

To display the shell intr character, type stty - a and press Return. A list of the stty 
settings is displayed. In this example, is the shell intr character: 

castle% stty -a 

ispeed 88840 baud; ospeed 88824 baud; 

rows = 36; columns = 113; ypixels = 478; xpixels = 801; 

eucw 1:0:0:0, scrw 1:0:0:0 

intr = "c; quit = <undef>; erase = ^h; kill = ''u; 

eof = "d; eol = <undef>; eol2 = <undef>; swtch = <undef>; 

start = ''q; stop = '-s; susp = ''z; dsusp = "y; 
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rprnt = ''r; flush = "o; werase = ■'w; Inext = ''v; 

-parenb parodd cs8 cstopb hupcl cread -clocal loblk crtscts crtsxoff parext 
-ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr icrni -iuclc 
ixon -ixany ixoff -imaxbel 

isig icanon -xcase echo echoe echok -echonl -noflsh 
-tostop echoctl -echoprt echoke -defecho -flusho -pendin iexten 
opost -olcuc onlcr -ocrnl -onocr -onlret -ofill -ofdel 
castle% 

Looking at the End of a File 

To look at the end of a file, type tail filename and press Return. The last 10 lines of the 
file (by default) are displayed. 

This example shows the tail of the / etc/ip/Systems file: 

castle% /usr/bin/tail /etc/lp/Systems 
# 

#ident "#(#)Systems 1.8 97/06/09 SMI” /* SVr4.0 1.2/ */ 

# This file previously contained an LP private interface. It's 

# contents are no longer used by the printing system and therefore 

# obsolete. Expect the file to be removed in a subsequent release 

# of Solaris, along with the Ipsystem(lM) command. 

+:x:-:bsd:-:n:10:Allow all connections 
castle% 

By default, the head and tail commands display 10 lines. You can change the number of 
lines displayed by using the - n option. Substitute the number of lines you want to display 
for the letter n. For example, to display the last 20 lines of a file, type tail -20 filename 
and press Return, 

NOTE, tail shows a maximum of 4096 bytes (about 400 lines). 

Looking at the Beginning of a File 

To look at the beginning of a file, type head filename and press Return. The first 10 lines 
of the file are displayed. 

This example shows the head of the /etc/passwd file: 

castle% /usr/bin/head /etc/passwd 

root:x:0:1:Super-User:/:/sbin/sh 

daemon:x:1:1::/: 

bin:x;2:2::/usr/bin: 

sys:x:3:3::/: 

adm:x:4:4:Admin:/var/adm: 

lp:x:71:8:Line Printer Admin:/usr/spool/lp: 

smtp:x:0:0:IVlail Daemon User:/: 

uucp:x:5:5;uucp Admin:/usr/lib/uucp: 

nuucp:x:9:9:uucp Admin:/var/spool/uucppublic:/usr/lib/uucp/uucico 

listen:x:37:4;Network Admin:/usr/net/nls: 

castle% 
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Changing File Ownership or Permissions 

Many user problems can be traced to file ownership or permissions problems. Use the Is 
command to check the permissions and ownership on a file. If you need to change one or 
both, use the chown, chmod, and chgrp commands. 

Changing File Ownership You must own a file or directory (or have root permis¬ 
sion) to be able to change its owner: 

1. Type Is -1 filename and press Return. The owner of the file is displayed in the third 
column. 

2. Become superuser. 

3. Type chown new-owner filename and press Return, Ownership is assigned to the new 
owner you specify: 

oak% Is -1 quest 

-rw-r--r-- 1 feed staff 6023 Aug 5 12:06 quest 

oak% su 

Password: 

# chown Ignatz quest 

# Is -1 quest 

-rw-r--r-- 1 ignatz staff 6023 Aug 5 12:06 quest 

# 

See Chapter 10, “Recognizing File Access Problems,” for more information. 

Changing File Permissions You can change file permissions by using the symbolic 
values r, w, x, and -.You can also change file permissions by using a set of octal numbers. 
Table 1-8 shows the octal values for setting file permissions. You use these numbers in 
sets of three to set permissions for owner, group, and other. For example, the value 644 
sets read/write permissions for owner and read-only permissions for group and other. 


Table 1-8 Octal Values for File Permissions 

Value Description 

0 No permissions 

1 Execute-only 

2 Write-only 

3 Write, execute 

4 Read-only 

5 Read, execute 

6 Read, write 
Read, write, execute 


7 
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1. Type Is -1 filename and press Return. The long listing shows the current 
permissions for the file. 

2. Type chniod nnn filename and press Return. Permissions are changed using the 
numbers you specify. 

NOTE. You can change permissions on groups of files, or on all files in a directory using 
metacharacters such as (*i} in place of file names or in combination with them. 

This example changes the permissions of a file fi-om 666 (read/write, read/write, 
read/write) to 644 (read/write, read-only, read-only); 


oak% Is -1 

quest 




-rw-rw-rw- 

oak% chmod 
oak% Is -1 

1 ignatz 
644 quest 

staff 

6023 Aug 

5 12:06 quest 

-rw-r--r-- 
oak% 

1 ignatz 

staff 

6023 Aug 

5 12:06 quest 


Changing File Group Ownership 

To change the group ownership of a file, type chgrp gld filename and press Return. The 
group ID for the file you specify is changed: 

$ Is -Ig junk 

-rw-r^-r-- 1 other 0 Oct 31 14:49 junk 
$ Chgrp 10 junk 
$ Is <lg junk 

-rw-r--r-- 1 staff 0 Oct 31 14:49 junk 
$ 

Group IDs are defined in the Group database or the local /etc /group file. See Chapter7, 
“Administering User Accounts and Groups,” for more information about groups. 

Setting or Displaying the System Environment 

The shell maintains an environment with a set of specifications that it gets from the shell 
initialization files. Users can also modify the shell environment for a session by issuing 
commands directly to the shell. The shell receives its information about the environment 
from environment variables. The SunOS 5.x system software provides several default 
environment variables: 

■ PS1 : Defines the shell prompt. The default prompt for the Bourne and Kom shells is $. 
The default prompt for the C shell is %. The default prompt for root in either shell is #. 
Users can specify a different shell prompt in the . profile, . login, or . cshrc files. 

■ home: Defines the absolute path to the user’s home directory. The default value for 
HOME is automatically defined and set to the login directory specified in the 
/etc/passwd file as part of the login process. The shell subsequently uses this 
information to determine the directory to change to when you type the cd command 
without an argument. 




44 



INTRODUCINQ SOLARIS SYSTEM ADMINISTRATION 


■ LOGNAME: Defines the user’s login name. The default value for lognAme is automatically 
defined and set to the login name specified in the /etc /passwd file as part of the login 
process. 

■ PATH: Lists, in order, the directories that the shell searches to find the program to run 
when the user types a command. If the directory is not in the search path, users must 
type the complete pathname of a command. The default path is automatically defined 
and set as specified in .profile (Bourne or Kom shell), or .cshrc (C shell) as part of 
the login process. The order of the search path is very important. When identically 
named commands exist in different locations, the first command found with that name 
is used. For example, suppose that path is defined (in Bourne and Kom shell syntax) 
as PATH=/ bin: /usr/bin: /usr/sbin:$HOME/bin and a file named sample resides in both 
/usr/bin and /home/jean/bin. If the user types the command sample wilhout 
specifying its full path name, the version found in /usr/bin is used. 



The LANG and LC environment variables specify the locale-specific conversions and 
conventions for the shell, such as time zones, collation order, format of dates, time, 
currency, and numbers. In addition, you can use the stty command in a user initialization 
file to set whether the system supports multibyte characters. 

LANG sets all possible conversions and conventions for the given locale. If you have special 
needs, you can set various aspects of localization separately by using the following LC 
variables; 


■ LC_COLLATE 

■ LC_CTYPE 

■ LC_MESSAGES 

■ LC^NUMERIC 

■ LC_N!ONETARY 

■ LC_TIME 

Table 1-9 lists the values for the lang and LC environment variables. 


Table 1-9 

Values for LANG and LC Variables 

Value 

Locale 

DE 

German 

FR 

French 

IS0_8859_1 

English and European 

IT 

Italian 

JAPANESE, 

Japanese 

KOREAN 

Korean 
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Table 1-9 Values for LANG and LC Variables (continued) 

Value Locale 

SV Swedish 

TCHINESE Taiwanese 


Other environment variables include: 

■ CALENDAR: Sets the path to the Calendar executables. 

■ CDPATH (or cdpath in the C shell); Sets a variable used by the cd command. If the 
target directory of the cd command is specified as a relative path name, the cd 
corrunand first looks for the target directory in the current directory (.). If the target is 
not found, the path names listed in the cdpath variable are searched consecutively until 
the target directory is found and the directory change is completed. 

■ DESKSET: Sets the path to the DeskSet"*^*^ executables. 

■ history: Sets history for the C shell. 

■ HZ: Sets history for Bourne and Korn shells. 

■ LPDEST: Sets the user’s default printer. 

■ MAIL: Tells the shell where to look for new mail. 

■ MANPATH: Sets the hierarchies of man pages available. 

■ MANSECTS: Sets the available sections of manual pages. 

■ openwinhome: Sets the path to the OpenWindows executables. 

■ prompt: Defines the shell prompt for the C shell. 

■ SHELL: Sets the default shell used by make, vi, and other tools. 

■ TERM (or term in the C shell): Defines the terminal. This variable should be reset in 
/etc/profile or /etc/. login. When the user invokes an editor, the system looks for a 
file with the same name as the definition of this environment variable. The system 
searches the directory referenced by terminfo to determine the terminal characteristics. 

■ TERMINFO; Specifies the path name for an unsupported terminal that has been added to 
the terminfo file. Use the terminfo variable in /etc/profile or /etc/ .login. 

■ TZ: Sets time zone. 

Users and system administrators can define additional variables for their own use. When 

you define an environment variable from a shell command, the variable remains in effect 

while you remain in the shell. When you exit the shell, the environment variable is not 

retained. Store “permanent” environment variables that are likely to be used during each 
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login session in the . profile, . login, or . cshrc file. The syntax for defining environment 
variables depends on the shell. 



Common Desktop Environment Environment Variables 

The Common Desktop Environment (CDE) has its own set of environment variables. 
Desktop search paths are created at login by the desktop utility dtsearchpath. The 
dtsearchpath utility uses a combination of environment variables and built-in locations to 
create the search paths. 


The environment variables that dtsearchpath reads are called input variables. These are 
variables set by the system administrator or end user. The input variables use the naming 
convention dtsp*. 


When dtsearchpath runs at login, it assembles the values assigned to these variables, adds 
built-in locations, and creates values for output variables. Each search path has an output 
variable, as shown in Table 1-10. 


Table 1-10 CDE Search Path Environment Variables 


Search Path Output Environment Variable Systemwide Input Variable 

Applications DTAPPSEARCHPATH DTSPSYSAPPHOSTS 

Database (actions, DTDATABASESEARCHPATH DTSPSYSDATABASEHOSTS 
data types, and front 
panel definitions) 

Icons XMICONSEARCHPATH, DTSPSYSICON 

XMICONBMSEARCHPATH 

Help data DTHELPSEARCHPATH DTSPSYSHELP 


Personal Input Variable 

DTSPUSERAPPHOSTS 

DTSPUSERDATABASEHOSTS 

DTSPUSERICON 

DTSPUSERHELP 


CDE components use the values of the output variables. For example. Application 
Manager uses the value of the application search path (dtappsearchpath) to locate 
application groups. For more information about CDE, refer to Solaris Common Desktop 
Environment: Advanced User’s and System Administrator Guide. 

Defining Bourne and Korn Shell Environment Variables 

To define an environment variable for the Bourne and Kom shells, type 
VWtIABLE=vaJue\QX'part K4AC4a££ and press Return: 

$ PS1=oak$;export PS1 

$ 

Defining C Shell Environment Variables 

To define an environment variable for the C shell, type setenv VARIABLE valus and press 
Return: 
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% setenv DISPLAY rogue:0 

% 

Displaying Environment Variable Settings 

To display a list of the current environment variable settings, type env and press Return: 

$ env 

HOME=/home/irving 

HZ=100 

LOGNAME=irving 

MAIL=/var/mail/irving 

MANSECTS=\1:1in:1c: 1f :1s:1b:2:\3:3c:3i:3n:3iii;3k:3g:3e:3x11:3xt:3w:3b:9:4:5:7:8 
PATH=/usr/bin 
SHELL=/bin/sh 
TERM=sun 
TZ=EST5EDT 
$ 

The following example shows all the environment variables for a system running CDE: 

castle% env 

MANPATH=/usr/openwin/share/inan:/usr/openwin/man:/usr/share/man:/usr/dt/share/man 
:/usr/dt/man:/usr/man:/opt/SUNWntvc/man 

DTDATABASESEARCHPATH=/export/home/winsor/.dt/types,/etc/dt/appconfig/types/%L,/e 
tc/dt/appconfig/types/C,/usr/dt/appconfig/types/%L,/usr/dt/appconfig/types/C 
DTXSERVERLOCATION=local 
LANG=C 

HELPPATH=/usr/openwin/lib/locale:/usr/openwin/lib/help 
DTSOURCEPROFILE=true 

PATH=/usr/openwin/bin:/usr/dt/bin:/bin:/usr/bin:/usr/ucb:/etc:. 
AB_CARDCATALOG=/usr/dt/share/answerbooks/C/ab_cardcatalog 
DTUSERSESSlON=winsor-castle - 0 

XMIC0NBMSEARCHPATH=/export/home/winsor/.dt/icons/%B%M.bm:/export/home/winsor/.dt 
/icons/%B%M.pm:/export/home/winsor/.dt/icons/%B:/usr/dt/appconfig/icons/%L/%B%M. 
bm:/usr/dt/appconfig/icons/%L/%B%M.pm:/usr/dt/appconfig/icons/%L/%B:/usr/dt/appc 
onfig/icons/C/%B%M.bm:/usr/dt/appconfig/icons/C/%B%M.pm:/usr/dt/appconfig/icons/ 
C/%B 

SESSION_SVR=castle 

OPENWINHOME=/usr/openwin 

EDITOR=/usr/dt/bin/dtpad 

LOGNAME=winsor 

DTSCREENSAVERLIST=StartDtscreenSwarm StartDtscreenQix StartDtscreenFlame 

StartDtscreenHop StartDtscreenImage StartDtscreenLife StartDtscreenRotor 

StartDtscreenPyro StartDtscreenWorm StartDtscreenBlank 

MAIL=/var/mail/winsor 

USER=winsor 

DISPLAY=:0.0 

SHELL=/bin/csh 

DTAPPSEARCHPATH=/export/home/winsor/.dt/appmanager:/etc/dt/appconfig/appmanager/ 
%L:/etc/dt/appconfig/appmanager/C:/usr/dt/appconfig/appmanager/%L:/usr/dt/appcon 
fig/appmanager/C 
HOME=/export/home/winsor 

XFILESEARCHPATH=/usr/openwin/lib/loca]e/%L/%T/%N%S:/usr/openwin/lib/%T/%N%S 
XMICONSEARCHPATH=/export/home/winsor/.dt/icons/%B%M.pm:/export/home/winsor/.dt/i 
cons/%B%M. bm: /export/home/winsor/ .dt/icons/%B: /usr/dt/appconfig/icons/%L/%B%iyi. pm 
:/usr/dt/appconfig/icons/%L/%B%M.bm:/usr/dt/appconfig/icons/%L/%B:/usr/dt/appcon 
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fig/icons/C/%B%M.pm:/usr/dt/appconfig/icons/C/%B%M.bm:/usr/dt/appconfig/icons/C/ 
%B 

TERM=dtterm 

dtstart_sessionlogfile=/dev/null 
TZ=US/Pacific 

DTHELPSEARCHPATH=/export/home/winsor/.dt/help/winsor-castle-0/%H:/export/home/wi 

nsor/.dt/help/winsor-castle-0/%H.sdl:/export/home/winsor/.dt/help/winsor-castle- 

0/%H.hv:/export/home/winsor/.dt/help/%H:/export/home/winsor/.dt/help/%H.sdl:/exp 

ort/home/winsor/.dt/help/%H.hv:/usr/dt/appconfig/help/%L/%H:/usr/dt/appconfig/he 

lp/%L/%H.sdl:/usr/dt/appconfig/help/%L/%H.hv./usr/dt/appconfig/help/C/%H:/usr/dt 

/appconfig/help/C/%H.sdl:/usr/dt/appconfig/help/C/%H.hv 

XMBINDDIR=/usr/dt/lib/bindings 

WINDOWID=79691820 

TERMINAL_EMULATOR=dtterin 

PWD=/export/home/winsor 

castle% 


Using the PATH Variable 

The PATH environment variable is very important. When the user executes a command 
using the full path name, the shell finds the command using that path name. However, 
when the user specifies only a command name, the shell searches the directories for the 
command in the order specified by the path variable. If the command is found in one of 
the directories, the shell executes it. 

A default su path (/sbin: /usr/sbin: /usr/bin: / etc) is set by the system, but most users 
modify it to add additional command directories. Many user problems related to setting up 
the environment and accessing the right version of a command or a tool can be traced to 
incorrectly defined paths. 

CAUTION! Including . in the path to search the current directory is a potential secu¬ 
rity problem. If security is an issue at your site, do not include . as part of a user’s path. 
Never use. as part of the root path. 

Setting the Path for Bourne and Korn Shells 

The path for the Bourne and Korn shells is specified in the user’s $hoivie/ . profile file in 
this way: 

PATH=/usr/bin:/$HOME/bin:. 

Setting the Path for the C Sheil 

The path for the C shell is specified in the user’s $HOME/ . cshrc file (with the set path 
environment variable) in this way: 

set path = (/usr/bin $home/bin.) 

See the appropriate manual pages for an in-depth description of these commands and 
Chapter 10, “Recognizing File Access Problems,” for more information about 
troubleshooting problems with paths. 
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Using Admintool 

Admintool is a graphical user interface that you can use to administer local systems. You 
can use Admintool to administer: 

■ User accounts 

■ Groups 

■ Hosts 

■ Printers 

■ Serial ports 

■ Software packages 


The next section describes how to start Admintool. 


Starting Admintool 

When using Admintool, you must be a member of the sysadmin UNIX group (GID 14) to 
run Admintool using your own UID, not as root. Anyone with root permissions on a local 
system can use Admintool to modify, create, or delete information in the local /etc files 
for that system. Use the following steps to start Admintool; 


1. Start Admintool from a command line by typing admintoolA and pressing Return. 
The Admintool window is displayed. 

2. Choose the Admintool view that you want to use from the Browse menu, shown in 
Figure 1-1. 



Introducing the Solstice AdminSuite Product 

The Solstice AdminSuite 2.3 unbundled product provides a suite of graphical user 
interface tools and commands that you can use to perform system administration tasks. 

i 

I 
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NTRODUCING SOLARIS SYSTEM ADMINISTRATION 


Solstice AdminSuite is included as part of the Solaris Server Intranet Extension 1.0 
CD-ROM that is shipped with each SMCC server. The following information is provided 
to help you evaluate whether the Solstice AdminSuite product is useful in your system 
administration environment. 

The Solstice AdminSuite software enables you to locally or remotely manage: 

■ Important system database files, such as aliases and hosts 

■ User accounts and groups 

■ File systems 

■ Disk slices and f disk partitions 

■ Terminals and modems 

■ Diskless and dataless clients 

■ AutoClient systems 

■ Stand-alone systems 

■ JavaStations 

■ Servers 

■ Printers 

The Solstice AdminSuite software to perform system administration benefits you in the 
following ways: 

■ Using the tools and commands is faster than using numerous Solaris commands to 
perform the same tasks. 

■ System files are updated automatically without the risk of making errors by editing 
important system files manually. 

■ You can manage systems remotely from one system. 

Table 1-11 lists the Solstice AdminSuite tools that run under an X Window System, such 
as the OpenWindows environment. 


Table 1-11 Solstice AdminSuite Toois 

AdminSuite Tool Description 

Host Manager Use to manage system information and server support for AutoClient 

and stand-alone systems, diskless and dataless clients, and 
JavaStations. 


Group Manager 


Use to manage UNIX group information. 
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Table 1-11 Solstice AdminSuite Tools (continued) 


AdmInSulte Tool 

User Manager 
Serial Port Manager 
Printer Manager 
Database Manager 


Description 

Use to manage user account information. 

Use to manage serial port software for terminals and modems. 

Use to manage printer software for print servers and clients. 

Use to manage network-related system files such as aliases and 
hosts. 


Storage Manager {comprising of Disk 
Manager and File System Manager) 


Use to manage disk slices and f disk partitions on a single disk or a 
group of equivalent disks (Disk Manager) and file systems for a 
server or for a group of clients on a sen/er (File System Manager). 


Because the Solstice AdminSuite product is unbundled, describing how to use the 
AdminSuite tools is beyond the scope of this book. For more information on obtaining 
Solstice AdminSuite, contact your Sun Microsystems sales representative or visit Sun’s 
Web site at http: / /www. sun. com and click on the Products & Solutions bnk. 
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T his chapter explains some basic operating system commands that 
help you find information about users and the system environment. It 
also describes several ways to create and edit files, combine com¬ 
mands and redirect output, display manual pages, and locate basic 
disk information. 

Finding User Information 

When administering systems, you often need to find out who is using the system and what 
they are doing. This section describes the commands— who, finger, rusers -l, whodo, id— 
that you can use to find information about users. 


Determining Who Is Logged In to a System 
{who, finger, rusers -I, whodo) 

You can use any one of four commands (who, finger, rusers -1, or whodo) to find out who is 
logged on to a system. Each command gives you different additional information. 

Using the who Command 

The who command displays a list of the users logged on to a system, with the login TTY port 
and the date and time. When a user is logged on remotely, the remote system name for that 
user is also displayed. To use the who command, type who and press Return. 

In this example, irving is logged on remotely (as shown by the system name), and ignatz is 
logged in locally to the system oak: 

oak% who 

irving pts/1 Oct 31 14:33 (elm) 

ignatz console Oct 31 12:22 
oak% 

Using the finger Command 

The finger command displays a list of the login names of users logged on to a system, along 
with the user’s complete name (from the information field of their /etc/password entry), the 
TTY port, the day of the week, the login time, and the remote system name if the user is 
logged in remotely. To use the finger command, type finger and press Return. 

In this example, user winsor is logged on remotely from castle: 

oak% rlogin drusilla 

drusilla% finger ^ 

Login Name TTY Idle When Where 

winsor Janice Winsor pts/0 11 Thu 09:59 castle 
drusilla% 
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Using the rusers -I Command 

The rusers - 1 (remote users, login) command displays a list of login names of users who 
are logged in on remote systems, along with the name of the system a user is logged in to, 
the TTY port, the month, date, login time, and idle time. If the host is not idle, no time is 
displayed in the last field. To use the rusers -l command, type rusers -l and press 
Return: 


cinderella% rusers -1 

Sending broadcast for rusersd protocol version 3... 
Sending broadcast for rusersd protocol version 2... 


]ah caps:console Mar 

amber faceholerconsole Mar 

sebree ondine:console Mar 

tut cairotconsole Mar 

jrt Cairo:ttyp5 Mar 

ramseyis mowthelawn:console Mar 

ramseyis mowthelawn'.ttypS Mar 

(More logins not shown) 
cinderella% 


This example shows six users logged in 
ports. 


3 

13:03 

22:03 


2 

07:40 



2 

10:35 

14 


2 

10:48 



2 

16:20 

47:54 

(gap) 

2 

16:33 

28 


3 

14:20 

25:14 

(:0.0) 


the console and two users logged in to TTY 



Using the whodo Command 

The whodo command displays the date, time, and system name. For each user logged in, 
the device name, UID, and login time are shown, followed by a list of active processes 
associated with the UID. The list includes the device name, PID, CPU minutes and 
seconds used, and process name. 


To find out who is logged in and doing what, type whodo and press Return: 


castle% whodo 

Thu Oct 9 14:38:59 PDT 1997 
castle 


console winsor 12:56 


? 

377 

0:00 

Xsession 

pts/2 

422 

0:00 

sdt_shell 

pts/2 

441 

0:00 

ttsession 

pts/2 

442 

0:00 

dtsession 

7 

453 

0:00 

snapshot 

7 

452 

0:02 

dtterm 

pts/3 

464 

0:00 

csh 

ptS/3 

618 

0:00 

whodo 

pts/5 

478 

0:00 

csh 

pts/4 

474 

0:00 

csh 

7 

451' 

0:02 

dtfile 

? 

489 

0:00 

dtfile 

? 

449 

0:02 

dtwm 

? 

450 

0:00 

dtpad 

pts/2 

425 

0:00 

csh 

7 

387 

0:00 

fbconsole 

7 

423 

0:00 

dsdm 
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pts/3 

winsor 

12:57 

pts/4 

winsor 

12:57 

pts/5 

winsor 

12:57 

castle% 




This example shows that user winsor is running a number of CDE applications. 


Finding User UID and GID Settings (id) 

Use the id command to display the user ID and group ID number for a user who is logged 
in. This information can be helpful for troubleshooting problems when users cannot 
access files they think they own, or when users want to find out which group they belong 
to. To use the id command, have the user log in, type id, and press Return. If the UID or 
GID does not match those for the troublesome file, you may need to change the 
ownership or group on the file or add the user to the appropriate group. See Chapter 5, 
“Administering Network Services,” for more information. 

This example shows the UID for user winsor is 6693 and the GID is 10. For superuser, the 
UID is 0 and the GID is 0 : 

anastasia% id 

uid=6693(winsor) gid=l0(staff) 

anastasia% su 

Password: 

# id 

uid=0(root) gid=1(other) 

# 


Finding Environment information 

Each shell maintains an environment with a set of specifications that it gets from the 
user’s initialization files (.profile for the Bourne and Kom shells or .cshrc and .login 
for the C shell) or from environment variables set interactively from a shell. These 
environment variables can specify information such as the user’s home directory, login 
name, default printer, location for e-mail messages, and path for accessing the 
OpenWindows environment. This section describes how to find environment variable 
settings (env). See Chapter 8, “Understanding Shells,” for more information. 

To find a user’s environment variable settings, type env and press Return. A list of the 
environment variables and their settings is displayed. See Chapter 1, “Introducing Solaris 
System Administration,” for a list of the default environment variables and for information 
on how to set them. 

This example shows the environment variable settings for user ignatz: 


oak% env 
H0ME=/ 



56 


Using Basic OS Commands 


PATH=.:/home/ignatz:/usn/bin: 

/home/ignatz/bin:/bin:/home/bin: /etc:/usr/etc 

LOGNAME=ignatz 

HZ=100 

TZ=PST8PDT 

TERM=sun 

SHELL=/bin/Csh 

MAIL=/var/mail/ignat 2 

PWD=/ 

MANSECTS=\1:1ni:1c:1f :1s:1b:2:\3:3 
c:3i;3n:3m:3l<:3g:3e:3x11:3xt:3w; 3b ;9:4:5;7:8 
oak% 


Creating and Editing Files 

This section describes how to create and edit files using these commands: cat, touch, cp, 
mv, Text Editor, and vi. 


Using the cat Command 

Use the cat command to create short files or to append a small amount of text to an 
existing file. Follow these steps to create files using the cat command: 

1. Type cat > filename and press Return. 

2. Type the text into the new file. 

3. Press Return. 

4. Press Control-D. The text is saved and the shell prompt is redisplayed. 

Follow these steps to append text to an existing file: 

1. Type cat » filename and press Return. 

2. Type the text to be appended to the file. 

3. Press Return. 

4. Press Control-D. The text is saved and the shell prompt is redisplayed. 

To view the contents of the file, type cat filename and press Return. The contents of the 
file are displayed. If the file is too long to fit in the terminal window, it’ll fly by and show 
you the lines at the end of the file that fit in the window or on the screen. 

The following example creates a file named kookaburra with the first verse of the 
kookaburra song, displays the contents of the file, appends the second verse to the file, and 
displays the contents again: 

castle% cat > kookaburra 
Kookaburra sits in the old gum tree 
Merry merry king of the bush is he 
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Laugh kookaburra, laugh kookaburra 
Gay your life must be. 

"D 

castle% cat kookaburra 
Kookaburra sits in the old gum tree 
Merry merry king of the bush is he 
Laugh kookaburra, laugh kookaburra 
Gay your life must be. 

castle% cat » kookaburra 
Kookaburra sits in the old gum tree 
Eating all the gumdrops he can see 
Stop kookaburra, stop kookaburra 
Leave some there for me. 

•'D 

castle% cat kookaburra 
Kookaburra sits in the old gum tree 
Merry merry king of the bush is he 
Laugh kookaburra, laugh kookaburra 
Gay your life must be. 

Kookaburra sits in the old gum tree 
Eating all the gumdrops he can see 
Stop kookaburra, stop kookaburra 
Leave some there for me. 
castle% 


Using the touch Command 

The touch command sets the access and modification times for each file to the current 
time. If a file does not exist, an empty one is created. You can use the touch command to 
create an empty file to check permissions and ownership or to create a file to which you 
will add text at a later time. 

To create an empty file, type touch filename and press Return. A new empty file is 
created. If the file exists, then its modification time is updated to the current date and time. 

The following example uses the is command to determine that there is not a file named 
junk, creates the file, and uses the is command to verify that the empty file is created: 

oak% Is -1 junk 

junk: No such file or directory 
oak% touch junk 
oak% Is -1 junk 

-rw-r--r-- 1 irving staff 0 Sep 11 15:06 junk 

oak% 


Copying (cp) or Renaming (inv) an Existing File 

You can create a new file by copying or renaming an existing file. 

To copy an existing file, type cp old-filename new-filename and press Return. You have 
made a copy of the file, retaining the original one: 
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oak% cp quest oldquest 
oak% 

To move (and rename) an existing file, type mv oM-filename new-filename and press 
Return. You have changed the name of the file and removed the old one. 

oak% mv quest /tmp/quest.old 
oak% 



Using Text Editor 

You can use the Open Windows Text Editor to create and edit files. You may, however, 
have problems using Text Editor to edit files that have root permissions. 

To start Text Editor from the OpenWindows workspace from the Workspace menu, choose 
Programs. Then choose Text Editor from the Programs menu. To start Text Editor from a 
command line, type /usr/openwin/bin/textedit & and press Return. A Text Editor 
window is displayed. Use the commands from the Edit menu or the Cut, Copy, Paste, and 
Undo keys from the keyboard to make editing changes. 

If you are running CDE you can use the CDE Text Editor to create and edit files. To start 
Text Editor from the CDE front panel, click on die Personal Applications menu and click 
on Text Editor. To start the CDE Text Editor from the command line, type 
/usr/dt/bin/dtpada and press Return. A Text Editor window is displayed. Use the 
commands from the Edit menu or the Cut, Copy, Paste, and Undo keys from the keyboard 
to make editing changes. 


Using vi 

The visual editor, vi, is commonly used by system administrators to edit text files. Whole 
books have been written about using vi. This section provides only a quick-reference 
table of some of the most commonly used editing commands. 

To start vi, type vi filename and press Return. If the file does not exist, a new file is 
opened. The new file is created when you save changes made to it. If the file exists, the 
beginning of the file is displayed. 

Table 2-1 shows a few of the many vi editing commands. 


Table 2-1 Some Basic vl Commands 


Task Command 

How to save/quft a file 

Quit without saving changes : q 1 

Write changes :w 

Write changes and quit :wq 
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I 

Table 2-1 Some Basic vi Commands (continued) 


; Write changes and quit 

ZZ 

How to move around In a file 


1 Move cursor one character left 

h 

i Move cursor one character right 

1 

; Move cursor up one line 

k 

Move cursor down one line 

] 

Go to end of the file 

G 

How to add text 


Insert text (insert mode) 

1 

i text Esc 

I Append text at cursor location 

a text Esc 

1 Append text at end of the line 

A text Esc 

! How to exit to command mode 

Esc 

How to make changes to a file 


Delete line 

dd 

1 Delete character 

i 

X 

j Delete word 

dw 

1 

1 . Open new line above 

0 text Esc 

! Open new line below 

0 text Esc 

! Yank/copy line 

Y 

! Put before 

P 

i Put after 

P 


Combining Commands and Redirecting Output 

The SunOS 5 .a: system software lets you combine commands in several ways. This 
section describes the three ways you can combine commands. 

Typing Several Commands on the Same Command Line 

You can type more than one command on a single command line by typing a semicolon 
(;) between the commands. 
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For example, you can change to a directory and list the commands by typing cd 

/usr/ bin;ls and pressing Return. Another example is setting an environment variable for 

the Bourne shell and then exporting the variable: 

PATH=.:/usr/bin:$HOME/bin;export PATH 

Redirecting Output (<>} 

Unless you indicate otherwise, commands normally display their results on the screen. 
You can, however, redirect the output of a command using the redirect symbols < and >. 
For example, to save the output to a file instead of displaying it on the screen, use the > 
redirect symbol to tell the shell to put the contents in a file. In this example, the output of 
the date command is redirected to a new file called sample .file: 

$ date > sample.file 
$ 

Here are the contents of sample, file; 

$ more sample.file 
Tue May 26 13:26:59 PDT 1992 
$ 

You can also redirect input in the other direction. For example, to mail the contents of a 
file to user ignatz@oak, type mail ignatz@oak < report.file and press Return. The file 
called report .file is sent by electronic mail to ignat 2 @oak. 

Combining Commands {!) 

You can use the pipe (|) operator to connect two or more commands, using the output 
from one command as the input to the next one. This section provides only two examples 
of the many ways you can combine commands in a pipeline. 

To print the cat(l) manual page, type man cat I Ip and press Return. The manual page is 
not displayed on the screen. Instead, the output is sent to the Ip command, which prints it 
on the default printer. 

You can search the process list for a particular command by piping the output of ps - e to 
the grep command. The output is displayed on the screen. For example, to display process 
information for OpenWindows: 

cinderella% ps -e | grep openwin 
260 ? 0:00 openwin 

cinderella% 

If you want to print the information, you can add an additional pipe command ({ ip) to 
the end of the sequence and send it to the printer: 

anastasia% ps -e ' grep openwin | Ip 

request id is castle-51 (request id is castle-51 (standard input) 

) 

anastasia% 
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Using Manual Pages 

Manual pages are on-line technical references for each SunOS 5.jt command. Manual 
pages are grouped into sections, with similar types of commands within the same section. 
For example, most user commands are in section (1), and system administration 
commands are in section (IM). Manual pages may be installed on a local system, or NFS 
mounted from a server. This section tells you how to display manual pages and how to 
find out the section numbers for an individual command. 


Displaying a Manual Page (man} 

To display a manual page, type man comend-name and press Return. The manual page is 
displayed: 

cinderella% man grep 

grep(1) USER COMMANDS grep{1) 

NAME 

grep - search a file for a pattern 
SYNOPSIS 

grep [ -bchilnsvw ] limited-regular-expression [ 

(More Informtion not shown in this example) 


Finding the Section Number for a Manual Page (whaiis, man) 

Some commands are listed in more than one section. You can find the section number(s) 
for a manual page using the whatis command. 

NOTE. The whatis command only works if you have used the catman command to set up 
your manual pages. To use the catman command to set up manual pages, become super 
user and type catman n and press Return, where n is the number of the section you want 
to set up. 


Follow these steps to find the section number for a manual page: 


1. Type whatis cmmand-name and press Return. The first line of the manual page for 
the command is displayed. Use the section number to display the manual page in the 
next step. 

2. Type man -aaeetion-number and press Return. The manual page is 

displayed: 


oak% whatis chown 


chown 

chown 

(1) 

- change 

chown 

chown 

(1b) 

- change 

chown 

chown 

(lm) 

- change 

chown 

chown 

(2) 

- change 

oak% man 
chown(2) 

1 -S2 1 

chown 

SYSTEM 


owner of file 

owner 

owner 

owner and group of a file 
CALLS 


chown(2) 
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NAME 

chown, Ichown, fchown - change owner and group of a file 
SYNOPSIS 

#include <unistd.h> 

#include <sys/types.h> 

int chown(const char *path, uid_t owner, gid_t group); 
int lchown(const char *path, uid_t owner, gid_t group); 
int fchown(int fildes, uid_towner, gid_t group); 

DESCRIPTION 

chownO sets the owner ID and group ID of the file specified by path or 
referenced by the open file descriptor fields to owner and group 
respectively. If owner or group is specified as -1, chown() does not change 
the corresponding ID of the file. 

(More text not shown here) 


Finding Disk Information 

Use the commands in the following sections to find disk use, and to tell if a file system is 
local (UFS) or remote (NFS). 


Displaying Used Disk Space in Kilobytes and Percentage of 
Capacity (df-k) 

The output from the df command, when used without arguments, is changed with the 
SunOS 5.x system software. Use the - k option to display disk information in the table 
format used with SunOS 4.x system software. T^pe df -k and press Return. The file 
system, total kilobytes, used kilobytes, available kilobytes, percentage of capacity used, 
and mount point for local disk partitions are displayed: 

Cinderella^ df-k 


dev/dsk/c0t0d0s0 

30383 

19926 

7427 

73% 

/ 

/dev/dsk/c0t0d0s6 

189683 

66503 

104220 

39% 

/usr 

/proc 

0 

0 

0 

0% 

/proc 

fd 

0 

0 

0 

0% 

/dev/fd 

swap 

44268 

12 

44256 

0% 

/tmp 

/dev/dsk/c0t0d0s7 

331953 

116133 

182630 

39% 

/opt 

/dev/dsk/c0t3d0s7 

189858 

24293 

146585 

14% 

/export/home 

Cinderella:(pid146) 

0 

0 

0 

0% 

/net 

Cinderella:(pid146) 

0 

0 

0 

0% 

/home 

Cinderella:(pid146) 

2448597 

2055423 

148315 

93% 

/usr/dist 

Cinderella:(pid146) 

763573 

574664 

112552 

84% 

/usr/svr4 

Cinderella:(pid146) 

818627 

540672 

196093 

73% 

/usr/netinstall 

Cinderella:(pid146) 

0 

0 

0 

0% 

/nse 

ud5-52a:/export/dist 2448597 

2055423 

148315 

93% 

/tnip_mnt/usr/dist 


cinderella% 
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Determining if RIe Systems Are Locai or NFS Mounted {difj 

To find out whether file systems are local or NFS mounted, type df fUeaystm and press 
Return. Disk formatting information (including disk location or mount point) for ±e file 
system you specify is displayed. 

In this example, the file system is NFS mounted: 

oak% df /home/ignatz 
bigriver:/export/home/ignatz 

538980 399435 85647 82% /tnip_tnnt/home/ignatz 

oak% 

In this example, the file system is on a local disk: 

# df / 

/dev/dsk/c0t0d0s0 30383 11885 15468 43% / 

# 


Rnding Aii Mounted File Systems of a Specific Type {df-F) 

If you want to display all the mounted file systems of one file system type, use the -F 
option followed by the file system type. The most common file system types are uf s for 
local file systems and nf s for network file systems. To find all mounted file systems of a 
specific type, type df -F and press Return. 

In this example, the mounted NFS file systems are displayed: 


cinderella% df -F nfs 


1 /net (Cinderella:(pid153)): 

0 blocks 

-1 

files 

i /usr/dist Cinderella:(pid153)): 

1276248 blocks 

■1 

files 

/home (Cinderella:(pid153)): 

0 blocks 

-1 

files 

! /usr/man (oak:/export/man): 

272934 blocks 

-1 

files 


cinderella% 

In this example, the mounted UFS (local) file systems are displayed: 
cinderella% df -F ufs 

/ (/dev/dsk/c0t0d0s0): 36992 blocks 13558 files 

/usr (/dev/dsk/c0t0d0s6): 274346 blocks 94403 files 

/export/home/cinderella (/dev/dsk/c0t3d0s7):379670 blocks 96046 files 
cinderella% 

In this example, information about the mounted temporary file system is displayed; 
cinderella% df -F tmpfs 

/tmp (swap ): 88528 blocks 3156 files 

cinderella% 

NOTE. You cannot use the df command to display SWAPFS file systems because they 
are never mounted. 
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T his chapter describes how to use tapes and diskettes to copy files. 

It also describes how to use Volume Management to access diskettes and 
CD-ROMs. You can also find information about devices in the following 
chapters of this book: 

■ See Chapter 4, “Administering File Systems,” for information about how to back up and 
restore complete file systems. Chapter 4 also explains disk device names and commands 
used for administering disks, introduces the Service Access Facility (SAF)—which you 
must use to administer terminals, modems, and other network devices with the SunOS 5jc 
system software—provides steps for setting up port monitors for print servers and print 
clients, and provides steps for adding a bidirectional Hayes-compatible modem to a 
system. 

■ See Chapter 6, “Administering Printing,” for information about administering printers. 

Using Tapes 

This section describes tape device-naming conventions, useful commands for streaming tape 
cartridges, and how to use the tar, cpio, and pax commands to archive and retrieve files from 
tapes. 

The tar, cpio, and pax commands can be used to copy files and file systems to tape. The 
command you choose depends on how much flexibility and precision you require for the 
copy. 

Use tar to copy files and directory subtrees to a single tape. Note that the SunOS 5.x tar 
command can archive special files (block and character devices, fifos), but the SunOS 4.x tar 
command cannot extract them. The cpio command provides better portability. 

Use cpio to copy arbitrary sets of files, special files, or file systems that require multiple tape 
volumes, or when you want to copy files from SunOS 5.x systems to SunOS 4.x systems. The 
cpio command packs data onto tape more efficiently than tar and skips over any bad spots in 
a tape when restoring. The cpio command also provides options for writing files with 
different header formats (tar, ustar, crc, ode, bar) for portability between systems of 
different types. 

Use pax to copy files, special files, or file systems that require multiple tape volumes or when 
you want to copy files to and from POSDC-compliant systems. 

Because tar, cpio, and pax use the raw device, you do not need to format or make a file 
system on tapes before you use them. The tape drive and device name you use depend on the 
hardware and configuration for each system. 
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Tape Device-Naming Conventions 

Tape drive-naming conventions use a logical—not a physical—device name. Tape drives 
fall into two categories according to controller type: 

■ Xylogics 472 for V 2 -inch rack-mounted (top-loaded) reel-to-reel drives (maximum four 
units per controller) 

■ SCSI for V4-inch cartridge, Vz-inch front-loaded reel-to-reel, and 4 mm or 8 mm helical 
scan drives (maximum eight units per controller) 

Within the /dev/rmt subdirectory is a single set of tape device files that support different 
output densities. In general, you specify a tape drive device as shown in Figure 3-1. 


Figure 3-1 

Tape drive device names. 


/dev/rmt/XAn 


Drive 

• 0 
1 
2 

3 

4 
n 


_w Optional 
No-Rewind 


Optional 

Density 


low 

medium 

high 

ultra 


no-rewind; 
omit for rewind 


Specifying the Drive Number Using the Default Density 

Normally, you specify a tape drive by its logical unit number, which is a number from 0 
to n. If you do not specify a density, the drive writes at its “preferred” density, which is 
usually the highest density the tape supports. 

To specify the first drive, use: 

/dev/rmt/0 

To specify the second drive, use: 

/dev/rmt/l 

NOTE. Most device names start their numbering sequence with zero (0). Consequently, 
when you talk about the first disk or target, its number is 0, not 1. 





I 


Using Tapes 


67 


Specifying Different Densities for a Tape Drive 

You may want to transport a tape to a system whose tape drive supports only a certain 
density. In that case, specify a device name that writes at the desired density. Use this 
convention: 

/dev/rmt/XA 

The unit and density characters are shown in Table 3-1. For example, to specify a raw 
magnetic tape device on the first (0) drive with medium density, use: 

/dev/rmt/0ni 


Table 3-1 

Unit and Density Characters in Tape Device Names 

Device Name 

= /dev/rmt/JM 

X 

Tape drive number (digit) from 0 to n, regardless of controller type 

A 

Density (character), depending on controller and drive type 

null 

Default, preferred (highest) density 

1 

Low 

m 

Medium 

h 

High 

u 

Ultra 

c* 

Compressed 


*New in this edition. 

Specifying the No-Rewind Option 

After the command is executed, the tape is automatically rewound unless you specify the 
no-rewind option as part of the device name. To specify no rewinding, type n at the end of 
the device name. 

For example, to specify a raw magnetic tape device on the first (0) drive with medium 
density, use: 

/dev/rii\t/0mn 

Understanding Device Abbreviations for 
Different Tape Controliers and Media 

You can have both SCSI and non-SCSI tape drives on the same system. A SCSI controller 
can have a maximum of eight SCSI tape drives, and a non-SCSI controller can have a 
maximum of four tape drives. For each drive number (X), the density character depends 
on the controller and drive type, as described in the following paragraphs. 





Table 3-2 shows the device abbreviations for different tape controllers/units and media. 
Note that the first character in the device abbreviation for drive number does not have to 
be 0 as shown, but could be 1,2, or 3, and so on, depending on how many tape drives are 
attached to the system. 


Table 3-2 Device Abbreviations for Tape Controllers/Units and Media 


Controller 

Drive Unit 

Size 

Type 

Format 

Tracks 

Device Abbreviation 

Xylogics 472 

Fujitsu M2444 

V 2 -inch 

Reel 

1600 bpi 

9 

/dev/rr(it/0m 



V 2 -inch 

Reel 

6250 bpi 

9 

/dev/rint/0h 

SCSI 

front-loaded 

HP 

V 2 -inch 

Reel 

800 bpi 

9 

/dev/rmt/0iT) 





6250 bpi 

9 

/dev/rmt/0h 

SCSI 

Sysgen 

V4-lnch 

Cartridge 

QIC-11 

4 

/dev/riiit/01 





QIC-24 

4 

/dev/ritit/0m 





QIC-11 

9 

/dev/rmt/01 





QIC-24 

9 

/dev/riTit/0in 


Emulex MT-02 

V4-inch 

Cartridge 

QIC-11 

4 

/dev/rmt/01 





QlC-24 

4 

/dev/rmt/0ni 





QIC-11 

9 

/dev/rmt/01 





QIC-24 

9 

/dev/rmt/0m 


Archive QIC-150 

'A-inch 

Cartridge 

QIC-150 

18 

/dev/rmt/0h 


Wangtek QIC-150 

'A-inch 

Cartridge 

QIC-150 

18 

/dev/rmt/0h 


Desktop Backup 
Pack 

'A-inch 

Cartridge 

QIC-150 

18 

/dev/rmt/0h 


Exabyte 8200 
(2.3 Gbyte)* 

8 mm 

Cartridge 

8 mm 

Helical scan 

/dev/rmt/0m 


Exabyte 8500 
(2.3 Gbyte)* 

8 mm 

Cartridge 

8 mm 

Helical scan 

/dev/rmt/01 


Exabyte 8500 
(5 Gbyte)* 

8 mm 

Cartridge 

8 mm 

Helical scan 

/dev/rmt/0ni 


Archive Python* 

4 mm 

Cartridge 

4 mm 

Helical scan 

/dev/rmt/0 


*New in this edition. 

Using Rack-Mounted Non-SCSI Va -Inch Reel Drives 

For V 2 -inch rack-mounted tape drives with either a Tapemaster or Xylogics 472 controller, 
substitute the density from Table 3-3 for the A variable in the device name (/dev/ rint /X4). 







Desi^ating Density for Rack-Mounted V 2 -Inch Tape Drives 

Density 

Default “preferred” (highest) density (usually 6250 bpi uncompressed) 

800 bpi 
1600 bpi 
6250 bpi 

6250 bpi compressed 


If you omit the density character, the tape is usually written at its highest density, not 
compressed. 

Using SCSI Vi-Inch Cartridge and Va-Inch Front-Loaded Reel Drives 

For SCSI V4-inch cartridge and V 2 -inch front-loaded reel drives, substitute the density 
from Table 3-4 for the A variable in the device name (/ dev / rmt / xa). 


Table 3-4 

Designating Format or Density for SCSI Tape Drives 

Character 

Density, -Inch Cartridge 

Density, V^-Inch Front-Loaded Reel-to-Reel 

null 

Default, preferred (highest) density 

Default, preferred (highest) density 

1 

QIC-11 format 

800 bpi 

m 

QIC-24 format 

1600 bpi 

h 

QIC-150 

6250 bpi 

u 

Reserved 

Reserved 


Table 3-3 

Character 

null 

1 

m 

h 

u 


For V4-inch cartridges, density is specified by the format in which the data is written: the 
QIC format. The QIC-11 and QIC-24 formats write approximately 1000 bpi on each track. 
The density for QIC-150 is somewhat higher. The preferred density for a 60-Mbyte 
V 4 -inch cartridge drive is QIC-24 and for a 150-Mbyte V4-inch cartridge drive is QIC-150. 

A 150-Mbyte drive can write only QIC-150; it cannot be switched to write QIC-24 or 
QIC-11. Format selection is only useful for drives that can write both QIC-24 and QIC-11. 

Specifying Helical Scan Drives 

Helical scan drives (for example. Exabyte 8 mm or Wang/DAT 4 mm) are a special case 
of SCSI drives. They write only at the preferred density. Consequently, you always 
specify them using only the drive number, for example, /dev/rmt /0. 
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Useful Commands for Streaming Tapes 

The following sections contain a few commands for use with streaming tapes. 

Retensioning a Magnetic Tape 

If errors occur when reading a tape, retension the tape, clean the tape drive, and then try 
again. Type mt -f /dev/rmt In retension and press Return. The tape in the tape drive you 
specify is retensioned. 

In this example, the tape in drive /dev/ rmt/t is retensioned: 

oak% mt -f /dev/rmt/t retension 
oak% 

Rewinding a Magnetic Tape 

To rewind a magnetic tape, type mt -f /dev/rtnt/yr rewind and press Return, The tape in 
the tape drive you specify by the device number n is rewound. 

In this example, the tape in drive /dev/rmt/iis rewound: 

oak% mt -f /dev/rmt/t rewind 
oak% 

Showing the Status of a Magnetic Tape Drive 

To show the status of a magnetic tape drive, type mt -f /dev/rmt m status and press 
Return. Status for the tape drive you specify is displayed. 

In this example, there is no tape in drive /dev/rmt /1: 

oak% mt -f /dev/rmt/1 status 

/dev/rmt/1: no tape loaded or drive offline 

oak% 

In this example, status is shown for the tape in drive /dev/rmt/i: 

oak% mt -f /dev/rmt/1 status 
Archive QIC-150 tape drive: 

sense key(0x6)= unit attention residual= 0 retries= 0 
file no= 0 block no= 0 
oak% 


The far Command 

Use the tar command to copy files and directory subtrees to a single tape. The advantages 
of the tar command are that it is available on most UNIX operating systems and public 
domain versions are readily available. The disadvantages of the tar command are that 
tar is not aware of file system boundaries, full path name length cannot exceed 255 
characters, it does not copy empty directories or special files such as device files, and it 
cannot be used to create multiple tape volumes. 
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The following sections describe how to use the tar command to copy files to a tape, list 
the files, append the files, and retrieve the files. 

Copying Files to a Tape (tar) 

Follow these steps to copy files to a tape: 

1. Change to the directory that contains the file you want to copy. 

2. Insert a write-enabled tape into the tape drive. 

CAUTION! Copying files to a tape using the c option fo tar destroys any files already 
on the tape. If you want to preserve the files already on the tape, use the r option de¬ 
scribed in ’’Appending Files to a Tape (tar)” later, 

3. Type tar cvf /dev/rtnt/y» filename filename filenam ... and press Return. The 
c (copy) option copies the files you specify, the v (verbose) option displays 
information about the files as they are copied, and the f (files) option followed by the 
tape device name specifies where the tar files are to be written. The file names you 
specify are copied to the tape, overwriting any existing files on the tape. 

NOTE. You can use metacharacters f? and *) as part of the file names you specify. For 
example, to copy all documents with a . doc suffix, type * .doc as the file name argument. If 
you specify a directory name as the file name, the directory and all its subdirectories are 
recursively copied to the tape. 

4. Remove the tape from the drive and write the names of the files on the tape label. 

In this example, two files are copied to a tape in tape drive 0: 

oak% cd /home/winsor 
oak% Is evaluation* 

evaluation.doc evaluation.doc.backup 
oak% tar cvf /dev/rmt/0 evaluation* 
a evaluation.doc 86 blocks 
a evaluation.doc.backup 84 blocks 
oak% 


Listing the Files on a Tape (tar) 

Follow these steps to list the files on a tape: 

1. Insert a tape into the tape drive. 

2. Type tar tvf /dev/rmt In and press Return. The t (table) option lists the files you 
specify, the v (verbose) option displays complete information about the files as they 
are listed in a form similar to the Is -i command, and the f (files) option followed 
by the tape device name specifies the device where the tar files are located. 

In this example, the table of contents for the tape in drive 0 contains two files: 

oak% tar tvf /dev/rmt/0 

rw-rw-rw-6693/10 44032 Apr 23 14:54 1991 evaluation.doc 
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rw-rw-rw-6693/10 43008 Apr 23 14:47 1991 evaluation.doc.backup 
oak% 

Reading from left to right, the first column shows the permissions for the file; the second 
column shows the UID and GID file ownership; the third column shows the number of 
characters (bytes) in the file; the fourth, fifth, sixth, and seventh columns contain the 
month, day, date, and year the file was last modified, and the final column contains the 
name of the file. 

Appending Files to a Tape (tai) 

Follow these steps to append files without overwriting files already on the tape: 

1. Change to the directory that contains the file you want to copy. 

2. Insert a tape that is not write-protected into the tape drive. 

3. Type tar rvf /dev/rmt/ir filename filename filename... and press Return. The 
file names you specify are appended to the files already on the tape in the drive you 
specify. 

NOTE. You can use metacharacters (l and *) as part of the file names you specify. For 
example, to copy all documents with a . doc sujfbc, type * .doc as the file name argument. 

4. Remove the tape from the drive and write the names of the files on the tape label. 

In this example, one file is appended to the files already on the tape in drive 0: 

oak% cd /home/winsor 
oak% tar cvf /dev/rmt/0 junk 
a junk 1 blocks 
oak% tar rvf /dev/rint/0 

rw-rw-rw-6693/10 44032 Apr 23 14:54 1991 evaluation.doc 

rw-rw-rw-6693/10 43008 Apr 23 14:47 1991 evaluation.doc.backup 

rw-rw-rw-6693/10 18 Dec 10 11:36 1991 junk 

oak% 

You can put more than one set of tar files on a tape if you use the n (no-rewind) option as 
part of the tape device name. For example, type tar cvf /dev/rmt Inn filename. The tape 
is not rewound after the files are copied, and the next time you use the tape, the files are 
written at the end of the previous set of files. 

Retrieving Files and Directories from a Tape (tar) 

Follow these steps to retrieve files from a tape: 

1. Change to the directory where you want to put the files. 

2. Insert the tape into the tape drive. 

3. Type tar xvf /dev/rmt/zr and press Return. All the files on the tape in the drive you 
specify are copied to the current directory. 

In this example, all files are copied from the tape in drive 0: 
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oak% cd /home/winsor/Evaluations 
oak% tar xvf /dev/rnit/0 

X evaluation.doc, 44032 bytes, 86 tape blocks 
X evaluation.doc.backup, 43008 bytes, 84 tape blocks 
oak% 

To retrieve individual files from a tape, type tar xvf /dev/rmt/^ filename filename 
filename ... and press Return. The file names you specify are extracted from the tape 
and placed in the current working directory. In this example, files with the prefix 
evaluation are copied from the tape in drive 0: 

oak% cd /home/winsor/Evaluations 
oak% tar xvf /dev/rmt/0 evaluation* 

X evaluation.doc, 44032 bytes, 86 tape blocks 
X evaluation.doc.backup, 43008 bytes, 84 tape blocks 
oak% 

Follow these steps to retrieve directories and subdirectories recursively from a tape: 

1. Change to the parent directory where you want to copy the files. If the directory already 
exists, be sure you are in the parent directory, and that it is okay to overwrite the contents 
of the directory before you copy the files from the tape. For example, to restore the 
contents of a directory named Book that is in /home/winsor/Book, you would change to 

/ home/winsor and type tar xvf /dev/rmt/rr Book and press Return. If you are in the 
directory /home/winsor/Book, the files will be restored as /home/winsor/Book/Book. 

2. Type tar xvf /dev/rmt//r directory-name and press Return. The directory and all 
its subdirectories are recursively copied from the tape. 

NOTE. The names of the files extracted from the tape exactly match the names of the 
files stored on the archive. If you have any doubts about the names or paths of the files, 
first list the files on the tape. See "Listing the Files on a Tape ftarj” earlier for instruc¬ 
tions and the tarfi j manual page for more information. 


The cpio Command 

The cpio command copies files, special files (files used to represent peripheral devices 
attached to a system), and file systems that require multiple tape volumes, and provides 
compatibility for copying files from SunOS 5.jr systems to SunOS 4.x systems. 
Advantages of using the cpio command are that it packs data onto tape more efficiently 
than the tar corrunand, skips over any bad spots in a tape when restoring files, provides 
options for writing files with different header formats (tar, ustar, crc, ode, bar) for 
portability between different system types, and creates multiple tape volumes. 

When you use the cpio command to create an archive, it takes a list of files or path names 
from standard input and writes to standard output. The output is almost always redirected to 
a file or device. The following sections describe how to use the cpio command to copy files 
to a cartridge tape, list the files, retrieve all files, and retrieve a subset of the files from a 
cartridge tape. 
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Copying All Files In a Directory to a Tape (cpio) 

Follow these steps to copy all files in a directory to a tape: 

1. Insert a write-enabled tape into the tape drive. 

2. Type Is [ cpio -oc > /dev/rmt //rand press Return. The o option copies the files. 
The c option writes header information in ASCII character form for portability. All 
the files in the directory are copied to the tape in the drive you specify, overwriting 
any existing files on the tape, and the total number of blocks copied is displayed. 

3. Remove the tape from the drive and write the names of the files on the tape label. 

In this example, all the files in the directory / home /winsor/TOi are copied to the tape in 
tape drive 0: 

oak% cd /home/winsor/TOI 
oak% Is I cpio -oc > /dev/rmt/0 
31 blocks 
oak% 

Listing the Flies on a Tape {cpio} 

To list files on a tape: 

1. Insert a tape into the tape drive. 

2. Type cpio -civt < /dev/rmt/v? and press Return. The i option reads in the contents 
of the tape. The v option displays the output in a format similar to the output from 
the Is -1 command. The t option lists the table of contents for the files on the tape 
in the tape drive you specify. 

NOTE. Listing the table of contents takes as long as it does to read the archive file be¬ 
cause the cpio command must process the entire archive. 

In this example, the table of contents for the tape in drive 0 contains four files: 


oak% cpio -civt 

< /dev/rrnt/0 




100666 winsor 

3895 

Feb 24 

15:13:02 

1992 

Boot.chapter 

100666 winsor 

3895 

Feb 24 

15:13:23 

1992 

Directory,chapter 

100666 winsor 

6491 

Feb 24 

15:13:52 

1992 

Install.chapter 

100666 winsor 

31 blocks 
oak% 

1299 

Feb 24 

15:14:00 

1992 

Intro.chapter 


The first column shows permissions in octal form; the second column shows the owner of 
the file; the third column displays the number of characters (bytes) in the file; the fourth, 
fifth, sixth, and seventh columns show the month, date, time, and year the file was last 
modified; and the final column shows the name of the file. 


I 
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Retrieving Ail Files from a Tape (cpio) 

If the archive was created using relative path names, the input files are built as a directory 
within the current directory. If, however, the archive was created with absolute path 
names, the same absolute paths are used to re-create the file. 

CAUTION! Using absolute path names can be dangerous because you can overwrite 
the original files. 

Follow these steps to retrieve all files from a tape; 

1. Change to the directory where you want to put the files. 

2. Insert the tape into the tape drive. 

3. Type cpio -lev < /dev/rmt//y and press Return. 

All the files on the tape in the drive you specify are copied to the current directory. 

In this exathple, all files are copied from the tape in drive 0: 

oak% cpio -iev < /dev/rint/0 

Boot.chapter 

Directory.chapter 

Install.chapter 

Intro.chapter 

31 blocks 

oak% 

Retrieving a Subset of Files from a Tape {cpio) 

You can retrieve a subset of the files from the archive by specifying a pattern to match 
using shell wildcard characters enclosed in quotation marks after the options: 

1. Change to the directory where you want to put the files. 

2. Insert the tape into the tape drive. 

3. Type cpio - iev " * fils" < /dev/ rmt / a and press Return. All the files that match the 
pattern are copied to the current directory. You can specify multiple patterns, but 
each must be enclosed in quotation marks. 

In this example, all files that end in the suffix chapter are copied from the tape in drive 0: 

oak% cd /home/winsor/Book 

oak% cpio -iev ''*chapter" < /dev/nnt/0 

Boot.chapter 

Directory.chapter 

Install.chapter 

Intro.chapter 

31 blocks 

oak% 

See the cpio(l) manual page for more information. 
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The pax Command 

The 2.5 release and later provide the pax command, which stands for portable archive 
interchange. The pax command provides better portability than the tar or cpio commands 
for POSIX-compliant systems. Use the pax command to copy files, special files, or file 
systems that require multiple tape volumes or when you want to copy files to and from 
POSIX-compliant systems. Disadvantages of the pax command are that it is not aware of 
file system boundaries and the full path name length cannot exceed 255 characters. 

Copying All Files in a Directory to a Tape (pax) 

Follow these steps to use the pax command to copy all the files in the current directory to 
a tape: 

1 . Change to the directory that contains the files you want to copy. 

2. Insert a write-enabled tape into the tape drive. 

3. Type pax -w -f </dev/rint la. and press Return. The -w option writes the current 
directory contents to tape. The -f option identifies the tape drive. The pax command 
does not list the files as they are copied. 

4. Type pax -1 -f </dev/nntand press Return. The-1 option lists the files on the 
tape to verify that the files are copied. 

5. Remove the tape from the drive and write the names of the files on the tape label. 

In this example, all files are copied from the tape in drive 0: 

castle% pax -w -f /dev/nnt/0 . 
castle% pax -1 -f /dev7rmt/0 

./addusr*1.rs 
./addusr-2.ra 
./at-addmn.ns 
. /at-base.rs 
./at-menu.rs 
castle% 

See the pax(l) manual page for more information. 

NOTE. When you use the pax command to copy files to a single-volume tape, you can 
also list and retrieve files from that tape by using the tar command. 

Retrieving All Files on a Tape (pax) 

Follow these steps to use the pax command to copy all the files on a tape into the current 
directory; 

1. Change to the directory where you want to copy the files. 

2. Insert a write-enabled tape into the tape drive. 
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3. Type pax -r -f </clev/rmt/^. and press Return. The-r option reads the contents of 
the tape to the current directory. The -f option identifies the tape drive. The pax 
command does not list the files as they are copied. 

4. Type Is -1 and press Return. The Is -1 command lists the files in the current 
directory and shows their permissions to verify that the files are copied. 

5. Remove the tape from the drive and write the names of the files on the tape label. 

In this example, all files are copied from the tape in drive 0: 


castle% pax -r -f /dev/rmt/O . 
pax: . ;not owner 


castle% Is -1 
-rw-rw-rw- 1 
-rw-rw-rw- 1 
-rw-rw-rw- 1 
-rw-rw-rw- 1 
-rw-rw-rw- 1 
castle% 


winsor 

staff 

winsor 

staff 

winsor 

staff 

winsor 

staff 

winsor 

staff 


245660 

245660 

181315 

181309 

181315 


Sep 

12 

11 

:52 

Sep 

12 

10 

;31 

Sep 

12 

10 

:29 

Sep 

12 

10 

;27 

Sep 

12 

10 

GO 

CM 


addusr-1.rs 
addusr-2.rs 
at-addmn.rs 
at-base.rs 
at-menu.rs 


Volume Management 


Starting with the Solaris 2.2 system software, volume management automates mounting 
of CD-ROMs and diskettes; users no longer need to have supemser permissions to mount a 
CD-ROM or a diskette. 


CAUTION! The Solaris 2.0 and 2.1 procedures for mounting CD-ROMs and diskettes 
will not work for Solaris 2.2 and later releases. Volume management controls the 
/dev/dsl</c0t6d0s0 path to a CD-ROM drive and the /dev/diskette path to the diskette 
drive. If you try to access a CD-ROM or diskette using these paths, an error message is 
displayed. 

Volume management provides users with a standard interface for dealing with diskettes 
and CD-ROMs. Volume management provides three major benefits: 

■ Automatically mounting diskettes and CDs simplifies their use. 

■ Users can access diskettes and CDs without having to become superuser. 

■ Users on the network can gain automatic access to diskettes and CDs mounted on 
remote systems. 


Mounting devices manually requires the following steps: 

1 . Insert media. 

2. Become superuser. 

3. Determine the location of the media device. 
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4. Create a mount point. 

5. Make sure you are not in the mount point directory. 

6. Mount the device using the proper mount options. 

7. Exit the superuser account. 

8. Work with files on media. 

9. Become superuser. 

10. Unmount the media device. 

11. Eject media. 

12. Exit the superuser account. 

Using volume management requires the following steps: 

1. Insert media. 

2. For diskettes, use the voicheck command. 

3. Work with files on media. 

4. Eject media. 

Volume Management Files 

Volume management consists of the /usr/sbin/vold volume management daemon, the 
/etc/void.conf configuration file used by the void daemon to determine which devices 
to manage, the / etc/rinmount. conf file used to configure removable media mounts, 
and actions in /usr/lib/rmmount. The volume daemon logs messages in the 
/var/adm/vold.log file. 

The default /etc/void, conf file is shown as: 

# @(#)vold.conf 1.21 96/05/10 SMI 

# 

# Volume Daemon Configuration file 

# 

# Database to use (must be first) 
db db_mem.so 

# Labels supported 

label dos label_dos.so floppy rmscsi pcmem 

label cdrom label_cdroiii.so cdrom 

label sun label_sun.so floppy rmscsi pcmem 

# Devices to use 

use cdrom drive /dev/rdsk/c*s2 dev_cdrom.so cdrotn%d 

use floppy drive /dev/rdiskette[0-9] dev_floppy.so floppy%d 

use pcmem drive /dev/rdsk/c*s2 dev_pcmem.so pcmera%d forceload=true 
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# use rmscsi drive /dev/rdsk/c*s2 dev_rmscsi.so rmscsi%d 

# Actions 

insert dev/diskette[0-9]/* user=root /usr/sbin/rminount 

insert dev/dsk/* user=root /usr/sbin/rmmount 

eject dev/diskette(0-9]/* user=root /usr/sbin/rtnmount 

eject dev/dsk/* user=root /usr/sbin/rmmount 

notify rdsk/* group=tty user=root /usr/lib/vold/v.olmissing -p 

# List of file system types unsafe to eject 
unsafe ufs hsfs pcfs 

If a system has additional diskette drives, volume management automatically creates two 
subdirectories in /vol/dev for each additional drive—one to provide access the file 
systems and the other to provide access to the raw device. For a second diskette drive, 
volume management creates directories named diskettel and rdiskettel. For a third 
diskette drive, it creates directories named diskettea and rdisketteS (and so on for 
additional drives). 

If you want additional CD-ROM drives on a system, you must edit the /etc/void.conf file 
and add the new devices to the Devices to use list. The syntax for a Devices to use entry 
is shown as; 

use device type special shared-object symname options 
Table 3-5 describes each of the fields for the Devices to use syntax. 


Table 3-5 

Device Control Syntax Descriptions 

Field 

Supported Default Values 

Description 

device 

cdroiTi, floppy 

The removable media device. 

type 

drive 

The type of device—multiple or single media 
support. 

special 

/dev/dsk/c0t6 /dev/diskette 

Pathname of the device to be used in the /dev 
directory. 

shared-object 

/usr/lib/void/shared-object-name 

Location of the code that manages the device. 

symname 

cdrom0, floppyD 

The symbolic name that refers to this device. 
The symname is placed in the device directory 
either /cdrom or /floppy). 

options 

user=nobody 

group=nobody 

mode=0666 

The user, group, and mode permissions for the 
inserted media. 


The /etc/ rmmount. conf file is shown as: 

# @(#)rmmount.conf 1.3 96/05/10 SMI 

# 

# Removable Media Mounter configuration file. 
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# 

# File system identification 

ident hsfs ident_hsfs.so cdrom 

ident ufs ident_ufs.so cdrom floppy rmscsi pcmem 

ident pcfs identpcfs.so floppy rmscsi pcmem 


# Actions 

action cdrom action_filemgr.so 
action floppy action_filemgr.so 
action rmscsi action_filemgr.so 

The files in the /usr/iib/vold directory are listed as: 

castle% Is -1 /usr/lib/vold 

db_mem,so.1 

db_nis.so.1 

dev_cdrom.so. 1 

dev_floppy.so. 1 

dev_pcmem.so. 1 

dev_rmscsi.so. 1 

dev_test.so.1 

eject_popup 

label_cdrom.so.1 

label_dos.so.1 

label_sun.so.1 

label_test.so.1 

volcancel 

volmissing 

volmissing_popup 

volstat 

castle% 


The files in the /usr/iib/rmmount directory are listed as: 

oak% Is -1 /usr/iib/rmmount 
action_filemgr.so. 1 
action_workman.so.1 
oak% 

If you encounter problems with volume management, check the / var/adm/vold. log file 
for information. An example of this file follows: 


oak% more /var/adm/vold.log 

Tue Jun 1 17:34:24 1993 warning: 

cdrom at /dev/dsk/c0t6 

Tue Jun 1 17:39:12 1993 warning: 

cdrom at /dev/dsk/c0t6 

Tue Jun 1 18:24:24 1993 warning: 

cdrom at /dev/dsk/c0t6 

Wed Jun 23 15:08:47 1993 warning: 

Wed Jun 23 15:09:58 1993 warning: 

Wed Jun 23 15:11:08 1993 warning: 

Thu Jul 15 13:51:23 1993 warning: 

Thu Jul 15 13:52:53 1993 warning: 

Thu Jul 15 14:04:37 1993 warning: 

Thu Jul 15 14:05:52 1993 warning: 


dev_use: couldn't find a driver for drive 
dev use: couldn't find a driver for drive 


dev use: couldn't find a driver for drive 


check device 36.2: 
check device 36.2: 
check device 36.2: 
check device 36.2: 
check device 36.2: 
check device 36.2: 
check device 36.2: 


device not managed 
device not managed 
device not managed 
device not managed 
device not managed 
device not managed 
device not managed 
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Thu Jul 15 14:06:16 1993 warning: check device 36.2: device not managed 
Wed Jul 21 16:33:33 1993 fatal: svc_tli_create: Cannot create server handle 
Thu Jul 22 16:32:28 1993 warning: cdrotn: /dev/rdsk/c0t6d0s2; Device busy 
castle% 

If you want to display debugging messages from the volume daemon, you can start the 
daemon by typing /usr/sbln/vold -v -L 10. With these flags set, the volume daemon 
logs quite a bit of information in /var/adra/void.log. 

Another way to gather debugging information is to mn the rmmount command with the 
debug flag. To do so, edit /etc/void .conf and change the lines that have 
/usr/sbin/rnimount to include the -D flag, as shown in the following example: 

insert /vol*/dev/diskette[0'9]/* user=root /usr/sbin/rmmount -D 


Volume Management Mount Points 

Volume management automatically mounts CD-ROM file systems on the /cdrom mount 
point when you insert the media into the drive. 

When you insert a diskette in the diskette drive, you rnust ask the system to check the 
diskette drive. You can check for a diskette in any one of the following ways: 

■ From the command line, type volcheck and press Return. 

■ From the CDE front panel, click on the Folders menu and then click on Open Floppy. 

■ From the CDE File Manager File menu, choose Open Floppy. 

■ From the OpenWindows File Manager File menu, choose Check for Floppy. 

When you use any of these methods, the files are mounted on the /floppy mount point. 
Table 3-6 describes the mount points and how volume management uses them. 


Table 3-6 

Medium 

Diskette 


CD-ROM 


Volume Management Mount Points 


Mount Point 

/floppy/floppy0 
/floppy/fioppy-oame 
/floppy/unnamed_floppy 
/cdrom/cdromO 
/cdrom/CD - ROM - name 


State of Medium 

Symbolic link to mounted diskette in local diskette drive 
Mounted named diskette 
Mounted unnamed diskette 

Symbolic link to mounted CD-ROM in local CD-ROM drive 
Mounted named CD-ROM 
I cdrom/CD-ROM-name/partition Mounted named CD-ROM with partitioned file system 
/cdrom/unnamed cdrom Mounted unnamed CD-ROM 
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If the medium does not contain a file system, volume management provides block and 
character devices in the /voi file system, as shown in Table 3-7. 


Table 3-7 

Solaris 2.3 CD-ROM and Diskette Device Locations When No File 
System Is Present 

Medium 

Device Location 

State of Medium 

Diskette 

/vol/dev/diskette0/ijnnamed_f loppy 

Formatted unnamed diskette-block device 
access 


/vol/dev/rdiskette0/unnamed_floppy 

Formatted unnamed diskette—raw device 
access 


/vol/dev/diskette0/unlabeled 

Unlabeled diskette—block diskette-raw device 
access 

CD-ROM 

/vol/dev/dsk/c0t6/u nnamed_cdrom 

CD-ROM—block device access 


/vol/dev/rdsk/c0t6/unnamed_cdrom 

CD-ROM—raw device access 


CD-ROMs and Volume Management 

The following sections describe how to access files from local and remote CD-ROM 

drives. 

Mounting a Local CD-ROM 

Use the following procedure to mount a CD-ROM from a local drive: 

1. Remove the protective film and remove the CD-ROM from its plastic case. 

2. Place the CD-ROM into its caddy so that the CD label is visible. 

3. Insert the caddy into the drive slot. The CD-ROM is automatically mounted on the 
/cdrom mount point. If File Manager is running, a window displays the contents of 
the CD-ROM, as shown in Figure 3-2. 

4. To access files on the CD-ROM from a command line, type cd /cdroni/cdroma and 
press Return. 

5. lype Is -L and press Return. The list of files in the /cdrom/cdrom© directory is 
displayed. Use the -l option because some of the files on the CD may be symbolic 
links. 
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You can use the File Manager CD-ROM window and the command line interchangeably. 
For example, you can eject a CD-ROM either from a command line by typing eject 
cdrom or by cUcking SELECT on the Eject button in the File Manager CD-ROM window. 


Figure 3-2 

The File Manager 
CD-ROM window. 



sc»L2i6_sparc 


Sharing Files from a Remote CD-ROM Drive 

Before you can share CD-ROM files from a command line, the mountd daemon must 
be running. On the system with the CD-ROM drive attached, type ps -ef | grep mountd 
and press Return. 

If the mountd daemon is mnning, other systems can access shared files. If the mountd 
daemon is not running, you need to stop NFS services and restart them. Be sure to notify 
any users of the system that NFS services will be interrupted momentarily when you use 
the following procedure. 

Use the following steps to start the mountd daemon: 

1. Become superuser. 

2. Type /Btc/rc3.d/Sl5nfs.server stop and press Return. NFS services are stopped. 

3. Type / etc/rc3.d/Sl5nfs.server start and press Return. NFS services are restarted 
and the CD files are exported. 

The following example uses the ps command to verify that the mountd daemon is not 
already running, and as superuser it runs the si 5nf s. server script to stop NFS services 
and restart them again: 




84 


Administering Devices 


oal<% ps -ef 1 grep mountd 

root 4571 4473 5 12-.53:51 pts/3 0:00 grep mountd 

oak% su 
Password: 

# /etc/rc3.d/S15nfs,server stop 

# /Btc/rc3.d/S15nfs.server start 

Use the following steps to share CD files from a remote CD-ROM drive: 

1. Insert the CD-ROM into the caddy and insert the caddy into the drive. The CD-ROM 
is mounted. 

2. Become superuser on the Solaris 2.2 (or later) system with the CD-ROM drive 
attached. 

3. Type share -F nfs -o ro /cdrom/cdromB and press Return. 

NOTE. Volume management does not recognize entries in the /etc/dfs/dfstab file. With 
Solaris 2.3 volume management, you can set up remote CD-ROM mounts to be automati¬ 
cally shared by editing the /etc /rmmount,conf file. Refer to the rminount. conf manual 
page for more information. 

The following example shares the files on the /cdrom/cdrom© mount point as NFS files and 
uses the ps command to verify that the mountd daemon is running: 

oak% su 
Password: 

# share -F nfs -o ro /cdrom/cdrom0 

# ps -ef I grep mountd 

root 4655 4473 6 12:56:05 pts/3 0:00 grep mountd 

root 4649 1 47 12:55:25 ? 0:00 /usr/lib/nfs/mountd 

# 

How to Access Shared CD-ROM Files 

You can use the /mnt directory as the mount point for the CD-ROM files, or you can cre¬ 
ate another directory. 

NOTE. Do not use the /cdrom mount point to mount local files. Volume management 
may interfere with accessing files on the volume management /cdrom mount point. 

When the CD-ROM is in the remote drive and the files are shared, follow these steps to 
access the shared files on a local system: 

1. On the local system, become superuser. 

2. Type mount remote-aystem - natm: f cdrom Iedrom0 and press Return. 

The files from the remote system directory /cdrom/cdrom0 are mounted on the 
/mount-point directory. The cdrom0 subdirectory is symbolically linked to the actual 
name of the CD-ROM that has a name assigned by the application vendor. 

In the following example, the files from the remote system castle are mounted on the 
/mnt mount point: 
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oak% su 
Password: 

# mount castle:/cdrom/cdromO /mnt 

# cd /mnt 

# Is 

SUNWssser SUNWsssra SUNWsssrb SUNWsssrc SUNWsssrd SUNWssstr 

# 

How to Unmount Shared CD-ROM Files 

When you are through using the CD-ROM files, use the following steps to unmount the 
remote CD-ROM: 

1. On the local system, become superuser. 

2. Type cd and press Return. 

3. Type umount /mount-point and press Return. The files from the remote system 
directory /cdrom/cdromO are unmounted. 


Diskettes and Volume Management 

When you insert a diskette into the diskette drive, volume management does not mount 
the diskette automatically; this prevents excessive reads, which can quickly wear out the 
diskette drive. You must use a conunand that checks for the presence of a diskette in the 
diskette drive. 

Command-Line Access 

Follow these steps to format a diskette from a command line: 

1. Insert a diskette into the diskette drive. 

2. Type volcheck and press Return. The system has access to the unformatted diskette. 

3. Type fdformat and press Return to format a UFS file system or fdf ormat -d to 
format an MS-DOS file system. 

4. When prompted, press Return to begin formatting the diskette. 

5. For UFS file systems, you must also make a new file system on the diskette. To do 
so, become a superuser, type newfs /vol/dev/rdiskette0/unnamed_floppy, and press 
Return. 

Follow these steps to access files on a formatted diskette: 

1. Insert a formatted diskette in the diskette drive. 

2. Type volcheck and press Return. If there is a formatted diskette in the drive, volume 
management mounts it on the /floppy mount point. If no diskette is in the drive, no 
error message is displayed. The volcheck command redisplays the prompt. When the 
diskette is mounted on the /floppy mount point, you can access files on it either 
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from the command line or from the File Manager Floppy window, described in 
“Open Windows File Manager Access” or “CDE File Manager Access.” 

3. Type cd /floppy and press Return. 

4. Type Is and press Return. The name of the diskette is displayed, 

5. Type cd diskette-naae and press Return. 

6. Type is and press Return. The names of the files on the diskette are displayed. You 
can copy files to and from the diskette using the cp command. 

In the following example, the diskette is not mounted, so the only directory in /floppy is 
ms-dos_5. After volcheck mounts the diskette, the directory with the name of the diskette 
is displayed. The diskette in this example contains only a lost+found directory: 

oak% cd /floppy 
oak% Is 
nis-dos_5 
oak% volcheck 
oak% Is 

ms-dos_5 unnanied_floppy 

oak% cd unnained_floppy 
oak% Is 
lost+found 

oak% cp /home/winsor/Appx/appxA.doc . 
oak% Is 

appxA.doc lost+found 
oak% 

You cannot unmount a file system whose current working directory is in use. If you get 
the message Device busy a process has its current working directory on the diskette. Use 
the fuser command to find out what process is using the diskette. See the f user(lM) 
manual page for information. 

Use the following steps to eject the diskette: 

1. Type cd and press Return. You have changed out of the /floppy directory. 

2. Type eject and press Return. After a few seconds, the diskette is ejected from the 
drive. 

OpenWIhdows File Manager Access 

If you are running File Manager, you can use it to format a diskette, display the contents, 
and copy files to and from the diskette. Follow these steps to format a diskette, display its 
contents, and eject it: 


1. Insert the diskette into the diskette drive. 










2. Choose Check for Floppy from the File menu, as shown in Figure 3-3 


Figure 3-3 

Choose Check for Floppy 
from the File menu. 


If the diskette is not formatted, a window is displayed, as shown in Figure 3^. Click 
SELECT on the Cancel & Eject button if you want to eject the diskette without 
formatting it. 


Figure 3-4 

The File Manager 
Unformatted Floppy 
window. 
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4. Click SELECT on the format you want to use, then click on Format Disk. The 
diskette is formatted and a new file system is created. 

5. When the diskette is formatted and contains the file system, the File Manager 
Floppy window displays the contents of the diskette, as shown in Figure 3-5, 


Rgure 3-5 

The File Manager Floppy 
window. 



lOESKTOP.FOl 


You can drag and drop files to and from the Floppy window in the same way that you 
manipulate other files using the File Manager. 

To eject the diskette, click SELECT on the Eject Disk button. After a few seconds, the 
diskette is ejected and the File Manager Floppy window is dismissed. 

CDE Front Panel Access 

If you are running CDE, you can use the Folders menu on the front panel to display the 
contents of a floppy. Follow these steps to open a floppy from the front panel: 

1. Insert a formatted or unformatted diskette into the diskette drive. 
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2. From the front panel, open the Folders menu, shown in Figure 3-6, and click on 
Open Floppy. 


After the light on the front panel stops flashing (about 5 to 10 seconds), the 
floppy is mounted to /floppy and a File Manager window opens. Figure 3-7 
shows an example of the File Manager floppy window for a formatted 
floppy. 


Figure 3-7 

The CDE File Manager 
floppy window. 


Figure 3-6 

The Front Panel Folders 


menu. 
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CDE File Manager Access 

If you are running CDE File Manager, you can use it to format a diskette, display the 
contents, and copy files to and from the diskette. Follow these steps to open a diskette 
from the CDE File Manager: 

1. Insert a formatted or unformatted diskette into the diskette drive. 

2. From the File Manager File menu, shown in Figure 3-8, choose Open Floppy. After 
the light on the front panel stops flashing (abut 5 to 10 seconds), the floppy is 
mounted to /floppy and a File Manager window opens. 

Figure 3-8 

The CDE File Manager 
menu. 



3. From the File Manager File menu you can also eject, format, and rename the diskette. 

Using the tar and cp/o Commands with Diskettes 

If a diskette contains tar or cpio files, volume management does not mount it. You cannot 
access files on the diskette from the old /dev/ rdiskette device name because volume 
management provides access to the media, not to the device. 

You can access tar and cpio files on a diskette using the symbolic link to the character 
device for the media that is in floppy drive 0, as: 

/vol/dev/aliases/floppy© 

Use the following steps to copy a file to a formatted diskette using the tar command: 

1. Insert a formatted diskette into the diskette drive. 

2. Type volcheck and press Return. 
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3. Type tan cvf /vol/dev/aliases/floppy0 filename wA press Return. The files are 
copied to the diskette. 

4. Type eject and press Return. After a few seconds, the diskette is ejected. 

Use the following steps to copy all tar files from a diskette: 

1. Insert a formatted diskette into the diskette drive. 

2. Change to the directory where you want to put the files. 

3. Type volcheck and press Return. The diskette is mounted. 

4. Type tar xvf /vol/clev/aliases/floppy0 and press Return. The files are copied to 
the diskette. 

5. Type ej act and press Return. After a few seconds, the diskette is ejected. 

Alternatively, with Solaris 2.2 (and later) systems, you can access tar or cpio files using 
the following device name syntax: 

/vol/dev/rfd0/media-name 

The most common media-name is unlabeled. 

With Solaris 2.3, the device name syntax is changed. You access tar or cpio files using the 
following device name syntax: 

/vol/dev/rdiskette0/media-name 

The most frequent media-name for media without a file system is unlabeled. 

For example, to copy a tar file to a diskette, type tar cvf /vol/dev/rdiskette0/ 
unlabeled filename and press Return. To retrieve all tar files from a diskette, type tar 
xvf /vol/dev/rdisketteO/unlabeled and press Return. 

Troubleshooting Volume Management 

From time to time, you may encounter problems with mounting diskettes (or, less 
frequently, a CD-ROM). If you encounter a problem, first check to find out whether 
volume management knows about the diskette. The best way to check is to look in 
/voi/dev/rdiskette0 to see if something is there. If the files are not mounted, you may 
have forgotten to run the volcheck command, or you may have a hardware problem. If 
references to /vol hang, the /usr/sbin/vold daemon has probably died, and you should 
restart it. 

If you find a name in /voi/dev/rdiskette0 and nothing is mounted in /floppy/ 
media -name, it is likely that the data on the media is not a recognized file system. It may be 
a tar, cpio, or Macintosh file system. You can access these media through the block or 
character devices found in /vol/dev/rdisketteo or /vol/dev/disketteo and use your own 
tools to interpret the data on them. 
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Using workman with Volume Management 

Many people use the workman program to play music from their CD-ROM drive, 
workman is not a Sun product, but it is in wide use. To use workman with volume 
management, add the hne shown in bold to the /etc/rmmount. conf file. Be sure the line 
comes before the cdrom action_f ilemgr line: 

# @(#)rnimount.conf 1.2 92/09/23 SMI 

# 

# Removable Media Mounter configuration file. 

P 

# File system identification 
ident hsfs ident_hsfs.so cdrom 
ident ufs ident_ufs.so cdrom floppy 
ident pcfs ident_pcfs.so floppy 

# Actions 

action cdrom action_workman;so pathname 
action cdrom action_filemgr.so 
action floppy action_filemgr.so 

A pathname is the name of the path where users access the workman program—for 
example, /usr/apps/pkgs/exe/workman. 

When you have made this change, audio CD-ROMs are automatically detected and the 
workman program is started when a CD-ROM is inserted into the CD-ROM drive. 

NOTE. When you set up workman in the way described here, users should not try to 
start workman from the application, because volume managementmay get confused. In 
addition, with Solaris 2.2 (and later) volume management, if you are using workman, you 
must eject the CD-ROM from the workman application. If you eject the CD-ROM from a 
nother window, workman hangs. This problem is fixed in Solaris 2.3 and later system 
software. 

Changes with Solaris 2.3 System Software 

With Solaris 2.2, you cannot automatically export CD-ROM and diskette drives or use the 
/etc/vf stab file. You must use the share command to export the file system after every 
reboot. 

NOTE. You cannot share a PCFS file system with Solaris 2.2 system software. 

With Solaris 2.3 system software, a share cdrom* instruction is provided in the 
/etc/rmmount. conf file so that a CD-ROM is automatically shared when it is inserted into 
the CD-ROM drive. You can specify flags in the same way as you do for the share 
command. You can also use the name of a particular piece of media, if desired. Refer to the 
nmmount. conf manual page for more details. 

With Solaris 2.3, the device names for the physical device have changed to be consistent 
with /dev. In Solaris 2.2 system software, the device names are /vol/dev/rfd0 and 
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/vol/dev/f d0. With Solaris 2.3 system software, the device names are 
/vol/dev/rdiskette0 and /vol/dev/disketteO. The symbolic link in /vol/dev/aliases 
always points to the correct device. 


Disabling Volume Management 

You may want to disable volume management for some users. To do so, use the following 
steps: 

1. Become superuser. 

2. Remove or rename the /etc/rc2.d/S92volnigt script. 

3. Type /etc/init.d/volmgt stop and press Return. 

You can disable part of volume management and leave other parts functional. You may, for 
example, want to automatically mount CD-ROMs, but use the Solaris 2.0 method for 
accessing files on a diskette. You can do so by commenting out the lines for diskettes in 
the /etc/vold.conf file, as shown: 

# @(#)V0ld.C0nf 1,21 96/05/10 SMI 

# 

# Volume Daemon Configuration file 

# 

# Database to use (must be first) 
db db_mem.so 

# Labels supported 

label dos label_dos.so floppy rmscsi pcmem 

label cdrom label_cdrom.so cdrom 

label sun label_sun.so floppy rmscsi pcmem 

# Devices to use 

use cdrom drive /dev/rdsk/c*s2 dev_cdrom.so cdrom%d 

# use floppy drive /dev/rdiskette[0-9] dev_floppy.so floppy%d 

use pcmem drive /dev/rdsk/c*s2 dev_pcmem.so pcmem%d forceload=true 

# use rmscsi drive /dev/rdsk/c*s2 dev_rmscsi.so rmscsi%d 

# Actions 

insert dev/diskette[0-9]/* user=root /usr/sbin/rmmount 

insert dev/dsk/* user=root /usr/sbin/rmmount 

eject dev/disketteI0-9]/* user=root /usr/sbin/rmmount 

eject dev/dsk/* user=root /usr/sbin/rmmount 

notify rdsk/* group=tty user=root /usr/lib/vold/volmissing -p 

# List of file system types unsafe to eject 
unsafe ufs hsfs pcfs 
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Using Diskettes Without Volume Management 

Use double-sided (DS), high-density (HD) 3.5-inch diskettes. Before you can copy ufs 
files or file systems to diskette, you must format the diskette. Use the tar command to 
copy ufs files to a single formatted diskette. Use cpio if you need to copy ufs files to 
multiple formatted diskettes. The cpio command recognizes end of media and prompts 
you to insert the next volume. 

You also can make a DOS-file system on a diskette. To use a DOS-formatted diskette, you 
mount the diskette as a pcfs file system and use basic OS commands such as cp and mv to 
archive and retrieve files from the diskette. 


Diskette Device Names 

The device name for the diskette drive has changed with the SunOS 5.x system software. 
The device name for the diskette drive is /dev/diskette. The raw device file for a diskette 
is /dev/rdiskette. 


Diskettes for ufs Fiie Systems 

The following sections describe how to format diskettes for use with ufs file systems, and 
describe how to copy files using the tar and cpio commands. They also describe how to 
retrieve files that were created using the SunOS 4.x bar command. 

Formatting a ufs Diskette 

Follow these steps to format a diskette for use with SunOS 5.x ufs file systems: 

1. Check the diskette to make sure that it is not write protected. 

2. Put the diskette in the drive. 

CAUTION! Reformatting destroys any files already on the diskette. 

3. Type fdformat and press Return. The message Press return to start formatting 
floppy is displayed, 

4. Press Return. While the diskette is being formatted, a series of dots (...) is 
displayed. When formatting is complete, the prompt is redisplayed; 

oak% fdformat 

Press return to start formatting floppy. 
oak% 

Removing a Diskette from the Drive 

Use the e j ect command to remove a diskette from the disk drive. You can also use the 
eject command to remove a CD-ROM disc from a CD-ROM drive. The default for the 
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ej ect command is /dev/diskette when you type it with no arguments. To remove a 
diskette from the diskette drive, type eject and press Return. The diskette is ejected. 

NOTE. If the drive jams, you can eject a diskette manually by sticking a straightened 
wire paper clip into the pinhole under the diskette slot. 

To eject a CD-ROM disc from a CD-ROM drive, type eject cdrom and press Return. 

Copying ufs Files to a Single Formatted Diskette 

This section provides steps for using the tar command to copy files to a single formatted 
diskette. Note that the tar command does not require the raw device name, 
/dev/rdiskette. You can use either the /dev/rdiskette or /dev/diskette device name. 
The examples in this book use the raw device name. 

Use the following steps to copy ufs files to a single formatted diskette: 

1. Change to the directory that contains the file(s) you want to copy. 

2. Insert a write-enabled formatted diskette protected into the drive. 

C AUTIO N S Copying files to a formatted diskette using the c option destroys any files al¬ 
ready on the diskette. If you want to preserve the files already on the diskette, use the r op¬ 
tion described in “Appending Files to a Formatted Diskette ( tarj” later. 

3. Type tar cvf /dev/rdiskette filename filename filename... and press Return. 
The file names you specify are copied to the diskette, overwriting any existing files 
on the diskette. 

NOTE. You can use metacharacters (? and *) as part of the file names you specify. For 
example, to copy all documents with a .doc suffix, type * .doc as the file name argument. 

4. Type eject and press Return to remove the diskette from the drive. The diskette is 
ejected from the drive. 

5. Write the names of the files on the diskette label. 

In this example, two files are copied to a diskette: 

oak% cd /home/winsor 
oak% Is evaluation* 

evaluation.doc evaluation.doc.backup 
oak% tar cvf /dev/rdiskette evaluation* 
a evaluation.doc 86 blocks 
a evaluation.doc.backup 84 blocks 
oak% eject 
oak% 

Listing the Hies on a Diskette (far) 

Follow these steps to list files that were copied using the tar command: 

1. Insert a diskette into the drive. 
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2. Type tar tvf /dev/rdiskette and press Return. The t option lists the table of 
contents for the files on the diskette. 

In this example, the table of contents for the diskette contains two files: 

oak% tar tvf /dev/rdiskette 

rw-rw-rw-6693/10 44032 Apr 23 14:54 1991 evaluation.doc 
rw-rw-rw-6693/10 43008 Apr 23 14:47 1991 evaluation.doc.backup 
oak% 

See the tar(l) manual page for more information. 

If you need a multiple-volume interchange utility, use cpio. The tar command is only a 
single-volume utility. 


Appending Files to a Formatted Diskette (tar) 

When you copy tar files to a formatted diskette, any files already on the diskette are 
overwritten. If you want to keep the files already on the diskette and add other files, 
follow these steps: 


1. Change to the directory that contains the file you want to copy. 

2. Insert a write-enabled formatted diskette protected into the drive. 

3. Type tar rvf /dev/rdiskette filename /ifieflairo and press Return. 

The file names you specify are appended to the files already on the diskette, 

NOTE. You can use metacharacters (? and *) as part of the file names you specify. For 
example, to copy all documents with a .doc suffix, type *.doc as the file name argument. 

4. Type e j ect and press Return to remove the diskette from the drive. The diskette is 
ejected from the drive. 

5. Write the names of the additional files on the diskette label. 


In this example, one file is appended to the files already on the diskette: 


oak% cd /home/winsor 

oak% tar rvf /dev/rdiskette junk 

a junk 1 blocks 

oak% tar tvf /dev/rdiskette 

rw-rw-rw-6693/10 44032 Apr 23 14:54 1991 

rw-rw-rw-6693/10 43008 Apr 23 14:47 1991 

rw-rw-rw-6693/10 18 Dec 10 11:36 1991 

oak% eject 

oak% 


evaluation.doc 
evaluation.doc.backup 
j unk 


Retrieving Files from a Diskette (tar) 

Follow these steps to retrieve files from a diskette: 


1. Change to the directory where you want to put the files, 

2. Insert the diskette into the drive. 






97 


Using Diskettes Without Volume Management 


3. Type tar xvf /dev/rdiskette and press Return. All the files on the diskette are 
copied to the current directory. 

4. Type eject and press Return to remove the diskette from the drive. The diskette is 
ejected from the drive. 

In this example, all files are copied from the diskette; 

oak% cd /home/winsor/Evaluations 

oak% tar xvf /dev/rdiskette 

X evaluation.doc, 44032 bytes, 86 tape blocks 

X evaluation,doc.backup, 43008 bytes, 84 tape blocks 

oak% eject 

oak% 

To retrieve individual files from a diskette, type tar xvf /dev/rdiskette filename 
filename filename .. . and press Return. The file names you specify are extracted from 
the diskette and placed in the current working directory. In this example, all files with the 
prefix evaluation are copied from the diskette: 

oak% cd /home/winsor/Evaluations 

oak% tar xvf /dev/rdiskette 

X evaluation.doc, 44032 bytes, 86 tape blocks 

X evaluation.doc.backup, 43008 bytes, 84 tape blocks 

oak% eject 

oak% 

Retrieving bar Files fronn Diskettes (cpio) 

The SunOS 4.x bar command is not provided with the SunOS 5.x system software. You 
can retrieve files from diskettes that were archived using the SunOS 4.x bar command by 
using the -H bar option to cpio. 

NOTE. You can use the -H bar option with -i to retrieve files only. You cannot create 
files with the bar header option. It is good practice to list the contents of an archive 
before extracting them. 

Follow these steps to retrieve bar files from a diskette; 

1. Change to the directory where you want to put the files. 

2. Insert the diskette that contains bar files into the drive. 

3. Type cpio -ivH bar < /dev/diskette and press Return. All the files on the diskette 
are copied to the current directory. 

4. Type eject and press Return to remove the diskette from the drive. 

Multiple Diskettes for Archiving Files {cpio) 

If you are copying large files or file systems onto diskettes, you will want to be prompted 
to replace a full diskette with another formatted diskette. The cpio command provides this 
capability. The cpio options you use are the same as you would use to copy files to tape. 
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except you would specify /dev/rdiskette as the device instead of the tape device name. 
See “The cpio Command” earlier for information on how to use cpio. 

Making a ufs File System on a Diskette {newfs /dev/rdiskette) 

If you want to mount a ufs diskette, you must make a file system on it first: 

1. Format the diskette. 

2. Become superuser. 

3. Type newfs /dev/rdiskette and press Return. 

A ufs file system is created on the diskette: 

oak% fdformat 

Press return to start formatting floppy. 


oak% su 
Password: 

# newfs /dev/rdiskette 

# 

Diskettes for pcfs (DOS) File Systems 

You can format diskettes with the pcfs file system for use with DOS systems. The 
following sections describe how to format a DOS diskette and how to mount the diskette 
for use with the SunOS 5.x system software. See Chapter 4, “Administering File 
Systems,” for a description of the pcfs file system. 

Formatting a Diskette with a pcfs (DOS) File System 

Follow these steps to format a diskette with the pcfs file system: 

1. Put a diskette in the drive. 

CAUTION! Reformatting destroys any files already on the diskette. 

2. Type fdformat -d and press Return. The message Press return to start 
formatting floppy is displayed. 

3. Press Return. While the diskette is being formatted, a series of dots (...) is displayed. 
When formatting is complete, the prompt is redisplayed, as shown in the following 
example: 

oak% fdformat -d 

Press return to start formatting floppy. 
oak% 
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Mounting a pcfs Diskette 

You can mount a pcfs diskette that was fonnatted using the f dformat -d command, or a 
DOS diskette that was formatted on a DOS system. When you mount a pcfs file system, 
you can create, read, write, and delete files in the file system using SunOS file utilities, 
subject to DOS naming conventions. See the pcf s(7) manual page for more information 
about the format and features of the pcfs file system. 

To mount a pcfs file system from a diskette: 

1. Insert the pcfs diskette in the drive. 

2. Become superuser. 

3. Type mount -F pcfs /dev/diskette awowf'/ioiirf and press Return. The file system 
is mounted on the mount-point you specify. 

You can mount a pcfs file system with different mount options (for example, -o rw). See 
the inount_pcf s(lM) manual page for a description of the options that can be included in 
the list. 

If you use pcfs diskettes frequently, you may want to add this entry to your /etc/vf stab 
file: 

/dev/diskette - /pcfs pcfs - no rw 

Create a directory named / pcfs to use as the mount point for the diskette. With the mount 
point and the entry in the /etc /vf stab file, you can mount a pcfs diskette by becoming 
superuser and typing mount / pcfs and pressing Return. Once the diskette is mounted, you 
can use any of the SunOS file utilities such as cp or mv to copy files to and from the 
diskette. 

Unmounting a pcfs Diskette 

When you are done with the pcfs diskette, you must unmount it before you can eject it. To 
unmount the diskette, type umount mount-point and press Return. To eject the diskette, 
type eject and press Return. 


Administering Disks 

The following sections describe the SunOS 5 jc disk naming conventions, coimnands for 
finding disk information (du, prtvtoc), and how to repair or replace a bad disk. 

Disk-Naming Conventions 

The SunOS 5 .a: disk-naming conventions are different from the SunOS 4.x disk-naming 
conventions. This section describes the new disk-naming conventions; these are based on 
logical (not physical) device names. SunOS 5 jc disks have both block and raw (character) 
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device files. The device name is the same, regardless of whether the command requires 
the block or raw device file. 

Instead of using an r to the beginning of the disk device name (the naming convention in 
the SunOS 4jc system software), each type of device file has its own subdirectory in /dev: 
/dev/dsk (the block interface) or /dev/rdsk (the raw interface). 

Some commands, such as mount, use the block interface device name from the /dev/dsk 
directory to specify the disk device. Other commands, such as newts, require the raw 
interface device name from the /dev/rdsk directory to specify the disk device. 

The device name you use to identify a specific disk with either type of interface depends 
on the controller type: bus-oriented (SCSI or IPI) or direct. 

Using Disks with Bus Controllers 

Figure 3-9 shows the device-naming convention for disks with bus controllers. 


Figure 3-9 

Naming convention for disks 
with bus controllers. 


cWtXdYsZ 



Slice (or partition) number (0 to 7) 
Drive number 

Physical bus target number 
Logical controller number 


Each file system on a disk is assigned to a slice — a group of cylinders set aside for use by 
that file system. To specify a slice (partition) on a disk with a bus controller (either SCSI 
or IPI), use a device name with these conventions; /dev/dsk/cwtxdvsz (the block 
interface) or /dev/rdsk/cWtXdVsZ (the raw interface). 

NOTE. SunOS 5.x disk device names use the term slice (and the letter s in the device 
name) to refer to the slice number. Slice is simply another name for a disk partition. 

Here are some guidelines for determining the values for the device file name: 

■ If you have only one controller on your system, W'is always 0. 

■ For SCSI controllers, X is the target address set by the switch on the back of the unit. 

■ v is the number of the drive attached to the target. If the disk has an embedded 
controller, Y is always 0. 
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■ Z is the slice (partition) number, with a value ranging from 0 to 7. To specify the entire 
disk, use slice 2. Table 3-8 shows conventional assignments of slice (partition) 
numbers for the disk on which root is found. 


Table 3-8 

Slice 

0 

1 

2 

3-5 

6 


Customary Assignments of Slices for Disk with Root 

File System Use 

coot Operating system 

swap Virtual memory space 

Entire disk 

Available for use according to your administrative policy 
/use Executable programs, program libraries, and documentation 


Table 3-9 shows some examples of raw device names for disks with bus-oriented 
controllers. 


Table 3-9 Examples of Device Names for Disks with Bus-Oriented Controllers 


Device Name 


Description 


/dev/rdsk/c0t0d0s0 Raw interface to the first slice (root) on the first disk at the first SCSI target address 
on the first controller. 

/dev/rdsk/c0t0d0s2 Raw interface to the third slice (which represents the whole disk) on the first disk at 
the first SCSI target address on the first controller. 


/dev/ rdsk/c0t1 d0s6 Raw interface to seventh (/usr) slice on the first disk at the second SCSI target 
address on the first controller. 


Using Disks with Direct Controllers 

Disks with direct controllers do not have a target entry as part of the device name. To 
specify a slice (partition) on a disk with a direct controller, use a device name with these 
conventions: /dev/dsk / cXdYsZ (the block interface) or /dev/rdsk/cXdYsZ (the raw 
interface). 
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Figure 3-10 shows the naming convention for disks with direct controllers. If you have 
only one controller on your system, x is always 0. Use slice 2 to specify the entire disk. 

Figure 3-10 cXdYsz 

Naming convention for disks 
with direct controllers. 


Slice (or partition) number (0 to 7) 
Drive number 

>■ Logical controller number 


Table 3-10 shows some examples of raw device names for disks with direct controllers. 


Table 3-10 Examples of Device Names for Disks with Direct Controllers 


Device Name 

/clev/rdsk/c0d0s0 

/dev/pdsk/c0d0s2 

/dev/rdsk/c0d1s6 


Description 

Raw interface to the first controller on the first disk to the first slice (root). 

Raw interface to the first controller on the first disk to the third slice (the entire disk). 

Raw interface to the first controller on the second disk to the seventh (/usr) slice. By 
convention, the slice numbers are assigned to specific file systems, as shown In 
Table 3-8. 


■ Setting Up Disk Slices 

Files are stored within file systems. Each disk slice is treated as a separate disk drive both 
by the operating system and by the system administrator. When setting up slices, 
remember: 

■ Each disk slice holds only one file system. 

■ No file system can span multiple slices. 

You set up slices differently on SPARC and x86 platforms, as described in Table 3-11. 

SPARC Disk Slices 

On SPARC systems, you define eight disk slices, and assign each to a conventional use, 
as described in Table 3-12. 
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Table 3-11 Slice Differences on Platforms 

SPARC Platform x86 Platform 

Entire disk Is used for Solaris environment Disk is divided into f disk partitions, one per operating 

environment. 

Disk is divided into eight slices, numbered 0-7 The Solaris fdisk partition is divided into 10 slices, 

numbered 0-9. 


Table 3-12 SPARC Disk Slice Conventions 


Slice 

0 

1 

2 


3 


4 

5 


6 


7 


RIe System Cllent/Server 

root Both 

swap Both 


Description 

Holds files and directories that make up the operating system. 
Provides virtual memory or swap space. 


— Both By convention, refers to the entire disk. The entire disk is defined 

automatically by the format command and the Solaris installation 
programs. Do not change the size of this slice. 

/export Server Holds alternative versions of the operating system that are 

required by client systems whose architecture differs from that of 
the server. Clients with the same architecture,type as the sen/er 
obtain executables from the /usr file system, usually slice 6. 


/export/swap Server 


Provides virtual memory/swap space for client systems. 


/opt Both Holds application software added to a system. If a slice Is not 

allocated for this file system during installation, the /opt directory 
is put in slice 0. 


/usr Both Holds operating system commands—also known as execotab/es— 

designed to be run by users. This slice also holds documentation, 
system programs such as init and syslogd, and library routines. 


/home or Both Holds files created by user accounts, 

/export/home 


x86 Disk Slices 

On x86 systems, you divide disks into fdisk partitions. Each fdisk partition is a section 
of the disk reserved for a particular operating environment. For a Solaris fdisk partition, 
you define 10 slices, numbered from 0 through 9, and assign each to a conventional use. 
The uses for slices 0 through 7 are the same as on Solaris systems, described in Table 
3-12. Table 3-13 describes slices 8 and 9. 

Determining Which Slices to Use 

When you set up file systems for a disk, you choose not only the size of each slice but 
which slices to use. Your decisions depend on the configuration of the system and the 
software you want to install on the disk. 
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Table 3-14 System Configurations and Slice Requirements 


Slice 

Servers 

Diskless Clients 

Stand-alone Systems 

AutoCllent Systems 

0 

root 

(on server) 

root 

root 

1 

O 

swap 

(on server) 

swap 

swap 

3 

/export 

— 

— 

_ 

4 

/export/swap 

— 

— 

— 

5 

/opt 

(on server) 

/opt 

(on server) 

6 

/usr 

(on server) 

/usr 

(on server) 

7 

/export/home 

(on server) 

/home 

(on server) 


Disk Use Check (cfu) 

To find the number of 512-byte disk blocks used per file or directory, type du and press 
Return. When directories contain subdirectories, the subdirectories and their contents are 
included in the block count; 


oak% du 

2913 ./3,0teniplates 
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lOS 


639 ./Art 

347 ./Howto 

1998 ./Clipart 

607 ./Newtemplates 

38 ./Modertistuff 

2004 ./Config/Art 

6593 ./Config 

13280 
oak% 



The output is displayed in 512-byte blocks. To convert to megabytes, divide by 2048. In 
this example 13280/2048 = 6.48 Mbytes. 


Disk Information Check (prtvtoc) 

Use the prtvtoc (print volume table of contents) command to display information about 
disk partitioning. The prtvtoc command works only when the slice you specify has space 
allocated to it. Otherwise, it displays the enor message No such device or address. If 
you use the standard slice-naming conventions, specifying slice 2 displays the contents of 
the entire disk. 

Follow these steps to display information about disk partitioning: 

1. Become superuser. 

2. Type prtvtoc I6e\iIrtishIcntminsn and press Return. Information for the disk you 
specify is displayed: 

oak% su 
Password: 

oak# prtvtoc /dev/rdsk/c0t1d0s2 

* /dev/rdsk/c0t1d0s2 partition map 

* 

* Dimensions: 

* 512 bytes/sector 

* 35 sectors/track 

* 6 tracks/cylinder 

* 210 sectors/cylinder 

* 1019 cylinders 

* 974 accessible cylinders 

* 

* Flags: 

* 1: untnountable 

* 10: read-only 

* 

* First 


* Partition Tag 

Flags 

Sector 

0 

0 

00 

0 

1 

0 

00 

24150 

2 

0 

00 

0 

6 

0 

00 

74550 

Sector 

Count 

Last 

Sector 

Mount 

Directory 
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24150 

24149 

50400 

74549 

204540 

204539 

129990 

204539 

oak# 


Bad-Disk 

Repair 


The following sections describe the steps for repairing a bad disk or reinstalling a new 
one. 


Try Archiving the Files 


If you can access the drive, do a uf sdump of all the file systems on the disk. See Chapter 4, 
“Administering File Systems,” for information on how to use the uf sdump conunand. 


Try Copying Data from the Disk 

If you cannot run uf sdump on the disk, find another disk of the same type, connect it to the 
system, and use either the dd or voicopy commands to copy the data from the bad disk. 
See the dd(lM) and volcopy(lM) manual pages for complete information on how to use 
these commands. 



The dd command makes a literal (block) copy of a complete UFS file system to another 
file system or to a tape. By default, the dd command copies its standard input to its 
standard output. 


NOTE. Do not use the dd command with variable-length tape drives. 

You can specify a device name in place of the standard input, the standard output, or both. 
In the following example, contents of a diskette are copied to a file in the /tmp directory: 

oak% dd < /floppy/floppyO > /tmp/output.file 
2400+0 records in 
2400+0 records out 
oak% 


The dd command reports on the number of blocks it reads and writes. The number after 
the + is a count of the partial blocks that were copied. 

The dd command syntax is different from most other commands. You specify options as 
keyword=value pairs, where keyword is the option you want to set and value is the 
argument for that option. For example, you can replace the standard input and output with 
the following syntax: 

dd lf=lnput-file of=output-file 

For example, to use the keyword^ value pairs instead of the redirect symbols in the 
previous example, you would type: 

oak% dd if=/floppy/floppy0 of=/tinp/output.file 

Follow these steps to clone a disk using the dd command: 
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1. Make sure the source and destination disks have the same geometry. 

2. Become superuser. 

3. On the system with the master disk, type touch /reconfigure and press Return. The 
/reconfiguration file is required on the system with the master disk so that it 
recognizes the clone disk once it is rebooted. 

4. Type init 0 and press Return to shut down the system. 

5. Attach the clone disk to the system and turn on the system. 

6. At the ok prompt type boot and press Return. 

7. Type dd /devfdsk/device-name /dev/dekidevice‘name h%=blockaize and 

press Return. The input file, if, is the master disk device. The output file, of, is the 
clone disk device. 

8. Type f sck /dev/rdak/device-name and press Return to check the new file system. 

9. Type mount I dev/rdak/device-name /mnt and press Return to mount the clone disk’s 
root file system. 

10. Edit the /etc/vf stab file on the clone disk to reference the correct device names. 

11. Type umount /mnt and press Return to unmount the clone disk’s root file system. 

12. Type init 0 and press Return to shut down the system. 

13. Type boot dislw -s and press Return to boot the clone disk in single-user mode. 

14. Type sys-unconf ig and press Return to unconfigure the clone disk. The system is 
shut down after the disk is unconfigured. 

15. Type boot disk/? and press Return to boot the clone disk. 

16. Provide the relevant system information such as host name, time zone, and so on. 

17. Log in as root to verify the system information once the system has booted: 

oak% su < /floppy/floppyO > /tmp/output.file 
oak# boot 

oak# dd if=/dev/dsk/c0t0d0s2 of=/dev/dsk/c0t2d0s2 bs=100k 

oak# fsck /dev/rdsk/c0t2d0s2 

oak# mount /dev/dsk/c0t2d0s2 /mnt 

oak# cd /mnt/etc 

oak# vi vfstab 

(Modify entries for the new disk) 

oak# cd / 

oak# umount /mnt 

oak# init 0 

oak# boot disk2 -s 

oak# sys-unconfig 

oak# boot disk2 
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Try Repairing Any Bad Blocks 

If the disk has bad blocks, you may be able to repair them using the format command. 

See the f ormat(lM) manual page for more information. 

Try Reformatting the Disk 

If the disk is bad, reformatting it may fix the problem. Use the format command to 
reformat a disk. See the forniat(lM) manual page for more information. 

CAUTION! Remember that formatting the disk destroys all data. 

Replacing the Bad Disk 

If reformatting and repairing bad blocks do not work, replace the disk. See the disk 
installation manual for more information. 

Adding Defect List, Format, Partition, and Label Disk (format) 

Follow these steps to put a defect list on a new disk, format, partition, and label it: 

CAUTION! You must format the disk after you add the defect list Any data on the disk 
will be destroyed by formatting. If the disk is not new, be sure the data is backed up before 
you proceed. See Chapter 4, “Administering File Systems, ” for complete information on 
how to back up and restore file systems. 

1. Become supemser. 

2. Type format and press Return. A list of available disks is displayed: 

AVAILABLE DISK SELECTIONS: 

0. c0t0d0 at scsibus0 slave 24 

scl0: <SUN0207 cyl 1254 alt 2 hd 9 sec 36> 

3. Type the number of the new disk from the list that is displayed. The Format menu 
and the format> prompt are displayed. 

4. Type defect and press Return. 

5. Type primary and press Return. The original defect list is added to the disk: 
defect> primary 

Extracting primary defect list . . . Extraction complete. 

Current Defect List updated, \ 
total of 30 defects, 

6. Type quit and press Return. The format> prompt is displayed. 

7. Type format and press Return. The disk begins formatting. Formatting takes about 
10 minutes for a 107-Mbyte disk, longer for bigger disks. 

8. When the format> prompt is redisplayed, type partition and press Return. 

9. Re-create the partitions to match the partitions on the defective disk. 
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10. Type label and press Return. The disk is labeled. 

11. Type quit and press Return. The Format menu and format > prompt are redisplayed. 

12. Type quit and press Return. The shell prompt is redisplayed: 

oak% su 
Password: 

# format 

Searching for disks...done 


AVAILABLE DISK SELECTIONS: 

0. sd0 at esp0 slave 24 

sd0: <SUN0207 cyl 1254 alt 2 hd 9 sec 36> 

1. sd2 at esp0 slave 16 

sd2: <SUN0207 cyl 1254 alt 2 hd 9 sec 36> 
Specify disk (enter its number): 1 
selecting C0t0d0 
[disk formatted] 

FORMAT MENU: 

disk 
type 

partition 
current 
format 
repair 
label 
analyze 
defect 
backup 
verify 
save 
inquiry 
volname 
quit 

format > defect 
defect > primary 
Extracting primary defect list . . . Extraction complete. 
Current Defect List updated, total of 30 defects, 
defect > quit 
format > format 
format> partition 
PARTITION MENU: 


0 

■ change 

•0' 

partition 

1 

- change 

T 

partition 

2 

- change 

•2' 

partition 

3 

- change 

'3' 

partition 

4 

- change 

'4' 

partition 

5 

- change 

'5' 

partition 

6 

- change 

'6' 

partition 

7 

- change 

'7' 

partition 

select 

- select 

a predefined table 


modify - modify a predefined partition table 
name • name the current table 
print - display the current table 


- select a disk 

- select (define) a disk type 

- select (define) a partition table 

- describe the current disk 

- format and analyze the disk 

- repair a defective sector 

- write label to the disk 

- surface analysis 

- defect list management 

- search for backup labels 

- read and display labels 

- save new disk/par.tition definitions 

- show vendor, product and revision 

- set 8-character volume name 
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label - write partition map and label to the disk 
quit 

partition> <partitiQn the disk> 
partition> label 
partition> quit 
format > quit 

# . 

Remaking the File Systems (neivfs) 

A disk must be formatted, partitioned, and labeled before you can create ufs file systems 
on it. If you are re-creating an existing ufs file system, unmount the file system before 
following these steps: 

1. Become superaser. 

2. Type newf s /dev/rdsk/e/TfffE(q5/7 and press Return. You are asked if you want to 
proceed. 

CAUTION! Be sure you have specified the correct device name for the partition before 
performing the next step. If you specify the wrong partition, you will erase its contents 
when the new file system is created. 

3. Type y to confirm. The newf s command uses optimized default values to create the 
file system. 

This example creates a file system on /dev/rdsk/c0t3d0s7: 

oak% su 
Password; 

# newfs /dev/rdsk/c0t3d0s7 

newfs; construct a new file system /dev/rdsk/c0t3d0s7 (y/n)? y 
/dev/rdsk/c0t3d0s7: 163944 sectors in 506 cylinders of 9 tracks, 36 sectors 

83.9MB in 32 cyl groups (16 c/g, 2.65MB/g, 1216 i/g) 
super-block backups (for fsck -b #) at: 

32, 5264, 10496, 15728, 20960, 26192, 31424, 36656, 41888, 

47120, 52352, 57584, 62016, 68048, 73280, 78512, 82976, 88208, 

93440, 98672, 103904, 109136, 114368, 119600, 124832, 130064, 135296, 

140528, 145760, 150992, 156224, 161456, 

# 

Mounting the File System on a Temporary Mount Point {mount} 

Type mount Idev/dsk/catnditsa /mnt and press Return. The file system is mounted on the 
/mnt temporary mount point. To mount the disk, specify the block device directory 
(/dev/dsk), not the raw device directory. 

Restoring Files to the File System {ufsrestore} 

Restore the contents of the latest full backup, and then restore subsequent incremental 
backups from lowest to highest level (ufsrestore), by following these steps: 

1. Type cd /mnt and press Return. You have changed to the mount point directory. 
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2. Write-protect the tapes for safety. 

3. Insert the first volume of the level 0 tape into the tape drive. 

4. Type ufsrestore rvf /6ev/rmtfa//Jt and press Return. If this is a multivolume 
restore, when prompted, remove the first tape and insert the last tape in the tape 
drive. Follow instructions about the order of the rest of the tapes. The level 0 tape is 
restored. 

5. Remove the tape and load the next lowest level tape in the drive. Always restore 
tapes starting with 0 and continuing until you reach the highest level. 

6. Type ufsrestore rvf /dev/rmt li/ffJt and press Return. The next level tape is 
restored. 

7. Repeat steps 5 and 6 for each additional tape. 

8. Type Is and press Return. 

9. A list of files in the directory is displayed. Check the listing to verify that all the files 
are restored. 

10. Type rm restoresymtable and press Return. The restoresymtable created by 
ufsrestore is removed. 

Unmounting the File System from its Temporary Mount Point {umount) 

Follow these steps to unmount the file system from its temporary mount point: 

1. Type cd / and press Return. 

2. Type urnount /mnt and press Return. The file system is unmounted from the 
temporary mount point. 

Checking the File System for Inconsistencies (fsck) 

T^pe fsck /6ey/r6skfcfftndns/r and press Return. The file system is checked for 

consistency. 

Performing a Level 0 Backup of the Restored File System {ufsdump) 

You always should do an immediate backup of a newly created file system because 

ufsrestore repositions the files and changes the inode allocation. 

Follow these steps to perform a level 0 backup of the restored file system: 

1. Remove the last tape and insert a new wiite-enabled tape in the tape drive. 

2. Type ufsdump 0uf /dev/rmt/«a/f /dev/rdsk/c/7f>70!i7s>7 and press Return. 
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Mounting the File System at Its Permanent Mount Point {mount) 

Type mount /dev/dsk/c/7*7oii75J7 and press Return. The restored file system is mounted 
and available for use. 


Understanding the Service Access Facility 

The SunOS 5.x system software uses the Service Access Facility (SAF) to register and 
monitor port activity for modems, terminals, and printers. SAF is new with the SunOS 5.x 
system software. The SAF controls the resources that let users: 

■ Log in (either locally or remotely) 

■ Access printers across the network 

■ Access files across the network 

The SAF is a complex hierarchy of background processes and administrative commands. 
Explaining the SAF in depth is beyond the scope of this book. The following sections 
provide a brief introduction to the elements of the SAF. For complete information about 
SAF, see the Solaris Advanced System Administrator’s Guide available from Sun 
Microsystems Press and Macmillan Technical Publishing. 

Admintool GUI for SAF Functionality 

Starting with the Solaris 2.3 release, Admintool provides a graphical user interface to 
work with printers, monitors, and modems. 

Starting Admintool 

Follow these steps to access the Admintool: Serial Ports windows: 

1. In a terminal window, type admintool& and press Return. The Admintool: Users 
window is displayed. 
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2. From the Browse menu, choose Serial Ports as shown in Figure 3-11. 



The Admintool: Serial Ports window is displayed, as shown in Figure 3-12. 


Figure 3-12 

The Admintool: Serial Ports 
window. 
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Click on one of the ports to highlight it, and choose Modify from the Edit 
menu. The Admintool: Modify Serial Port window is displayed, as shown in 
Figure 3-13, 


Figure 3-13 

The Admintool: Modify 
Serial Port window. 



This window shows information at three different levels: Basic, More, and 
Expert. Figure 3-14 shows the Expert options. 


Figure 3-14 

The Admintool: Modify 
Serial Port window with 
Expert options. 



Port Monitors and Service Access 

A port monitor is a program that continuously watches out for requests to log in or 
requests to access printers or files. When a port monitor detects a request, it sets the 
parameters that are needed to establish conununication between the operating system and 









the device that is requesting service. Then the port monitor transfers control to other 
processes that provide the services needed. 

The SunOS 5.x system software provides two types of port monitors: listen and ttymon. 
The listen port monitor controls access to network services, fielding remote print and file 
system requests. The ttymon port monitor controls access to login services. You will need 
to set up a ttymon port monitor (using SAP) to process login requests from modems. 

NOTE. The ttymon port monitor replaces the SunOS 4.x getty port monitor. A single 
ttymon can replace multiple getties. 

SAF Control of Port Monitors and Services 

You use three SAF commands to administer modems and alphanumeric terminals: 
sacadm, pmadm, and ttyadm. 

The sacadm command adds and removes port monitors. This command is your main link 
with the Service Access Controller (SAC) and its administrative file (/etc/saf /_sactab). 

The pmadm command adds or removes a service and associates a service with a particular 
port monitor. 

The ttyadm command formats information for inclusion in various SAF administrative 
files. A ttyadm command often is embedded within a sacadm or pmadm command to provide 
some of the data needed by those commands. Table 3~15 lists the programs associated 
with specific SAF functions. See the manual pages for more information about each 
command. 


Table 3-15 SAF Functions and Associated Programs 


Function 

Program 

Description 

Overall administration 

sacadm 

Command for adding and removing port monitors 

Service Access Controller 

sac 

SAP’s master program 

Port monitors 

ttymon 

Monitors serial port login requests 


listen 

Monitors requests for network services 

Port monitor service 
administrator 

pmadm 

Command for controlling port monitors’ services 

Services 

logins: remote procedure 
calls; other 

Services to which SAF provides access 


Setting Up Printer Port Monitors 

This section provides steps for setting up port monitors for printing. Each SunOS 5 jc print 
server and print client must have the port monitor configured to be able to handle network 
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printing requests. If you use the Printer Manager (available with SunOS 5.1), you do not 
need to follow these steps. The Printer Manager automatically sets up the port monitors as 
part of the printer configuration process: 

1. Become superuser. 

2. Type sacadm -a -p tcp -t listen -c '7usr/lib/saf/listen tcp" -v 'nlsadmin 
-V' -n 9999 and press Return. The network listen service that listens for incoming 
TCP/EP requests is started. The options are described in Table 3-16. 


Table 3-16 The sacadm Command Options 

Option Description 

-a Adds the-p port 

-t Identifies the type of service 

-c Tells which command to use to start the port monitor 

-V Indicates the version of the network listen process 

- n Specifies the number of times the Service Access Controller will restart the process, if it dies 


3. Type sacadm -1 and press Return. Look at the output to verify that the network listen 
status is enabled, as shown in this example: 

# sacadm -1 

PMTAQ PMTYPE FLGS RCNT STATUS COMMAND 

tcp listen - 9999 ENABLED /usr/lib/saf/listen tcp # 

NOTE. It may take several minutes before the network listen service is enabled. 

4. Type Ipsystem -A and press Return. The system’s universal address is displayed, as 
shown in this example: 

# Ipsystem -A 

00020203819418060000000000000000 

The universal address has four parts, as shown in Figure 3-15. The last part, RFU, means 
Reserved for Future Use and could be used for other families of addresses (for example. 
Open Systems Interface) in the future. 


Figure 3-15 

Parts of the universal 
address. 


0002 


Internet 


0203 
TCP Port 


8194148060000 

- 1 - 

IP 


000000000000 

RFU 
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The first four digits identify the Internet family. The fifth through eighth digits identify the 
TCP port. For the modified version, replace the fifth through eighth digits with 0 ACE. For 
example, the modified version of the universal address shown in the example above is: 

00020ACE819418060000000000000000 

NOTE. You must type the characters \xat the beginning of the universal (or modified 
universal) address in the next steps exactly as shown. In addition, the address must be en¬ 
closed in single quotation marks so the backslash is not stripped off. 

Follow these steps to set up a printer port monitor: 

1. To register listen service 0, type pmadm -a -p top -s e -i root -m 'nisadmin -c 
/usr/lib/saf/nlps_server -A '\xmodifletl_addre8s" -v 'nisadmin -V and press 
Return. The port monitor is configured to listen for requests from listen service 0. 

2. To receive print requests from SunOS 5,0 print clients, type pmadm -a -p top -s Ip 
-i root -m 'nisadmin -o /var/spool/lp/fifos/listenS5' -v 'nisadmin >V' and 
press Return. The port monitor is configured to listen for requests from listenSS, 
which registers print requests from SunOS 5.x print clients. 

3. To receive print requests from SunOS 4.x print clients, type pmadm -a -p top -s 
Ipd -1 root -m 'nisadmin -o /var/spool/lp/flfos/listenBSD -A '\xaddress'' 

-V 'nisadmin -V and press Return. The port monitor is configured to listen for 
requests from listenBSD, which registers print requests from SunOS 4 j: print clients. 

4. Type cat /var /saf /top/ log and press Return. Examine the messages displayed to 
make sure that the services are enabled and initialized. In this example, all three 
network listen services are registered: 

# Ipsystem -A 

00020203819418060000000000000000 

# pmadm -a -p tcp -s Ip -i root -m 'nisadmin -o 
/var/spool/lp/fifos/listenS5' -v 'nisadmin -V' 

# pmadm -a -p tcp -s Ipd -i root -m 'nisadmin -o 
/var/spool/lp/fifos/listenBSD -A 

'\x00020203819418060000000000000000'' -V 'nisadmin -V' 

# pmadm -a -p tcp -s 0 -i root -m 'nisadmin -c 
/usr/lib/saf/nlps_server -A 

'\X00020ACE819418060000000000000000' ' -V 'nisadmin -V' 
pine# cat /var/saf/tcp/log 

10/28/91 10:22:51; 178; 0(#)list6n:listen.c 1.19.9.1 
10/28/91 10:22:51; 178; Listener port monitor tag: tcp 
10/28/91 10:22:51; 178; Starting state: ENABLED 
10/28/91 10:22:51; 178; Service 0: fd 6 addr 
\X00020ACE819418060000000000000000 
10/28/91 10:22:51; 178; Service Ipd: fd 7 addr 
\X00020203819418060000000000000000 

10/28/91 10:22:52; 178; Net opened, 2 addresses bound, 56 fds free 
10/28/91 10:22:52; 178; Initialization Complete 

# 
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Setting Up a Local Printer by Using Admintool 

You can use Admintool to set up access to a printer or to configure a local printer. Use the 
following steps to access a network printer: 

1 . Type admintoois and press Return to start Admintool (if necessary). 

2. From the Browse menu, choose Printers. The Admintool: Printers window is 
displayed, as shown in Figure 3-16. 


Figure 3-16 

The Admintool: Printers 
window. 





3. From the Edit menu, choose Add and Access to Printer. The Admintool: Add Access 
to Printer window is displayed, as shown in Figure 3-17. 


Figure 3-17 

The Admintool: Add Access 
to Printer window. 
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4. Enter the printer name, print server name, and description. 

5. If you want this printer to be the default printer, click on the Default Printer check 
box. 


6. Click on the OK button. The printer is configured and the printer information is 
added to the list in the Admintool: Printers window. 
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Use the following steps to add a local printer: 

1. Type admintooia and press Return to start Admintool (if necessary). 

2. From the Browse menu, choose Printers. 

3. From the Edit menu, choose Add and Local Printer. The Admintool: Add Local 
Printer window is displayed, as shown in Figure 3-18. 



4. Enter the printer name and description. 

5. Choose the printer port, printer type, file contents, and fault notification. 

6. If you want to specify this printer as the default printer, check the Default Printer 
check box. 

7. If you want to always print the banner, check the Always Print Banner check box. 

8. Modify the User Access List (if necessary). 
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9. When you have completed the setup, click on the OK button. The printer is 

configured and the printer information is added to the list in the Admintool: Printers 
window, as shown in Figure 3-19. 


Figure 3-19 

The Admintool: Printers 
window. 



Setting Up a Bidirectional Modem 

To set up a bidirectional modem you need information for these variables: 

■ port-name Which port the modem is connected to (typically, ttya or ttyb). 

■ svctag The name of the port monitor service (for Sun systems, zsmon) 

■ port-device-name The name of the device for the port (typically /dev/cua/a or 
/dev/cua/b). 

■ short-port - device - name The name for the port without the complete path. 

■ modem-label The entry in the /etc/ttydefs file that is used to set the proper baud 
rate and line discipline. 

■ modem■ type The type of the modem from the / etc /uucp/ Dialers file. For example, 
the type for a Hayes modem is hayes. 

Follow these steps to configure a modem: 

1. Halt the system. 

2. Make sure hardware carrier detect is disabled. On Sun systems, you can use the 
eeprom command or type setenv ttyb- ignore -cd=false and press Return. 

3. Reboot the system. 

4. Connect the modem and make sure any modem switches are set to allow 
bidirectional use. 
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5. To remove the existing service for the port name so that the modem can be 
connected, type pmadm -r -p svctag -s port-name, and press Return, If you get the 
message Invalid request, svctag does not exist, the svctag port monitor is not 
configured. To configure the svctag port monitor, type sacadm -a -p svctag -t 
ttymon -c /usr/lib/saf/ttymon -v 'ttyadm -V and press Return. 

6. To set up the port monitor for use with the modem, type pmadm -a -p zsmon -s ttyb 
-i root -fu -V 1 -m "'ttyadm -b -d /dev/term/b -1 conttySH -m 
ldterm,ttcompat -s /usr/bin/login -S n'" and press Return. The-b option sets 
the bidirectional flag. The -m options specify streams modules to be pushed, 

7. To make sure the /etc/remote file has an entry for /dev/cua/n and that it is set to the 
correct baud rate, type grep cueu? /etc/remote and press Return. In this example, the 
information for cuab is correct: 

# grep cuab /etc/remote 

cuab:dv=/devycuayb:br#2400* 

# 

If the entry is not in the y etc/remote file, edit the file and add the entry. 

8. Edit the /etcyuucpyDevices file and add this entry: 

ACU termyshort-port-device-name,M - modem-label modem-type 

Follow these steps to configure a bidirectional Hayes-compatible modem for dialing in 

and dialing out on serial port B. The default switch settings for a Hayes Smartmodem 

2400 work properly: 

1. Halt the system, 

2. Hardware carrier detect must be disabled. To reset the PROM setting to disable 
hardware carrier detect on Sun systems, type setenv ttyb-ignore-cd=false and 
press Return. 

3. Reboot the system. 

4. Connect the modem and make sure any modem switches are set to allow 
bidirectional use. Note that the Hayes Smartmodem 2400 requires no changes to the 
default switch settings to work properly. Connect the modem cable to serial port B. 

5. To remove the existing service for ttyb so that the modem can be connected, type 
pmadm -r -p zsmon -s ttyb and press Return. If you get the message Invalid 
request, zsmon does not exist , the zsmon port monitor is not configured. To 
configure the zsmon port monitor, type sacadm -a -p zsmon -t ttymon -c 
/usrlibysaf yttymon -v 'ttyadm -V and press Return. 

6. To set up the port monitor for use with the modem, type pmadm -a -p zsmon -s b -i 
root -fu -V 1 -m "'ttyadm -b -d /dev/cua/b -1 conttySH -m ldt6rm,ttcompat 
-s yusry bln/login -S y '" and press Return. The -b option sets the bidirectional 
flag. The -m options specify STREAMS modules to be pushed. 
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7. To make sure the /etc /remote file has an entry for /dev/cua / b and that it is set to 
the correct baud rate, type grep cuab /etc/remote. If the following information is 
displayed, the entry is correct: 

# grep cuab /etc/remote 
cuab:dv=/dev/cua/b:br#2400* 

# 

If the entry is notin the /etc/remote file, edit the /etc /uucp/Devices file and type ACU 
term/b,M - conttySH hayes. 


Using a Modem 

To connect through the modem, type tip -baud rate phone number and press Return. 
With the Hayes Smartmodem 2400, this command dials and connects to the system. 
When the software on the connecting system is configured properly, the remote system 
dials the rilodera phone number and the modem answers automatically. 

This example uses the information phone number, which is not a dial-in modem number: 

oak% tip -2400 5551212 

dialing ... connected 
<Login messages> 
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A FILE SYSTEM IS A STRUCTURE OF DIRECTORIES USED TO LOCATE AND STORE 

■ To describe the entire file tree from the root directory downward 

■ To describe a particular type of file system: disk-based, network-based, or pseudo 

■ To describe the data structure of a disk slice or other media storage device 

■ To describe a portion of a file tree structure that is attached to a mount point on the main 
file tree so that that portion is accessible 

Usually, you can tell from context which meaning is intended. 

The SunOS 5.x system software uses the virtual file system (VFS) architecture, which 
provides a standard interface for different file system types. The kernel handles basic 
operations^—such as reading, writing, and listing files—without requiring the user or 
program to know about the underlying file system type. 

The file system administrative commands provide a common interface that allows you to 
maintain file systems of different types. These commands have two components: a generic 
component and a component specific to each type of file system. The generic commands 
apply to most types of file systems; the specific commands apply to only one type of file 
system. 

Administering the SunOS 5.x file system is one of your most important system 
administration tasks. The file system story is a complex one, and understanding it can help 
you more effectively administer file systems. This chapter describes: 

■ The types of file systems 
■ The default SunOS 5.x file system 
■ The virtual file system table (/etc /vf stab) 

■ The file system administrative commands 
■ Making local and remote files available to users 
■ Backing up and restoring file systems 


New File System Features in Solaris 2.6 

The Solaris 2.6 release provides some new file system features. Each of these new features is 
introduced in the following sections. 
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Large Files 

The mount command provides a new option, -largef iles, that is the default mount option 
for the Solaris 2.6 environment. This option enables you to create file systems that can 
contain files larger than 2 Gbytes. When files are mounted with the -largef iles option, a 
file system may contain files larger than 2 Gbytes, but it is not required. See “Making File 
Systems Available” for more information. 


NFS Client Failover 

With the NFS client failover feature, you can specify additional hosts from which to 
mount a file system in case the first host cannot be reached. You can either set this feature 
in die /etc/vf stab file or issue your list of hosts from the command line. 

WebNFS 

The WebNFS feature, sometimes called Public NFS, provides two additional options to 
the mount command: 

■ The -index filename option automatically loads a file matching filename if it is found 
in a directory referenced by an NFS URL. 

■ The -public option resets the public file handle to the current directory. This option 
enables you to access files through an NFS URL even if the file system cannot be 
mounted in the usual way. 

See “Making File Systems Available” on page 138 for more information. 


Types of File Systems 

The SunOS 5.x system software supports three types of file systems: 

■ Disk-based 

■ Network-based 

■ Virtual (previously called pseudo) 


Disk-Based File Systems 

Disk-based file systems are stored on physical media such as hard disks, CD-ROMs, and 
diskettes. Disk-based file systems can be written in different formats. The available 
formats are: 

■ UFS UNDC file system (based on the BSD Fat Fast File system that was provided in 
the 4.3 Tahoe release). The default disk-based file system in SunOS 5.x system 
software is UFS. 








Types of File Systems 


127 


■ S5FS x86 UNIX file system (based on the BSD Fat Fast File system that was 
provided in the 4.3 Tahoe release). The default disk-based file system in SunOS 5.x 
x86 system software is S5FS. 

■ HSFS High Sierra and ISO 9660 file system. High Sierra is the first CD-ROM file 
system; ISO 9660 is the official standard. The HSFS file system is used on CD-ROM, 
and is a read-only file system. The SunOS 5.x hsfs supports Rock Ridge extensions, 
which provide all UFS file system semantics and file types except for writability and 
hard links. 

■ PCFS PC file system, which allows read/write access to data and programs on 
DOS-formatted floppy disks written for DOS-based personal computers. 

The System V (S5) file system traditionally provided with System V releases is not 
included in the SunOS 5.x system software because of significant limitations, such as a 
maximum of 64,000 files in a file system, a restriction of 14 characters for file names, and 
lack of a quota facility. 

Each type of disk-based file system is customarily associated with a particular media 
device: 

■ UFS and S5FS with hard disk and'any other media (tape, CD-ROM, diskette) 

■ HSFS with CD-ROM 

■ PCFS with diskette 

These associations are not, however, restrictive. For example, CD-ROMs and diskettes 
can have UFS file systems installed on them. 


Network-Based File Systems 

Network-based file systems are file systems that are accessed over the network. Typically, 
network-based file systems are file systems that reside on one system and are accessed by 
other systems across the network. The available network-based file systems are: 

■ NFS—network or distributed file system 

■ RFS—remote file sharing 

The default SunOS 5.x distributed file system is NFS. You administer distributed file 
systems by sharing them (exporting them from a server) and mounting them on individual 
systems. See “Making File Systems Available” later in the chapter for more information. 


Virtual File Systems 

Virtual file systems (previously called pseudo file systems) are virtual or memory-based 
file systems that provide access to special kernel information and facilities. Most virtual 
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file systems do not use file system disk space. Some pseudo file systems, such as the 
temporal^ file system, may, however, use the swap space on a physical disk. Cache file 
systems use a file system on the disk to contain the cache. 

The Cache File System 

You can use the Cache File System (CacheFS) to improve performance of remote file 
systems or slow devices such as CD-ROM drives. When a file system is cached, the data 
read from the remote file system or CD-ROM is stored in a cache on the local system. See 
“Creating Cache File Systems” on page 155 for more information. 

The Temporary nie System (TMPFS) 

The TMPFS file system, uses local memory for disk reads and writes. Access to files in a 
TMPFS file system is typically much faster than access to files in a UFS file system. Files 
in the TMPFS file system are not permanent. They are deleted when the file system is 
unmounted and when the system is shut down or rebooted. 

The default file system type for the /tmp directory in the SunOS 5.x system software is 
TMPFS. You can copy or move files into or out of the /tmp directory, just as you would in 
a uf s /tmp file system. 

UsingTMPFS file systems can improve system performance by saving the cost of reading 
and writing temporary files to a local disk or across the network. For example, temporary 
files are created when you compile a program. The operating system generates a lot of 
disk or network input and output activity while manipulating these files. Using TMPFS 
file systems to hold these temporary files may significantly speed up their creation, 
manipulation, and deletion. 

The TMPFS file system uses swap space as a temporary storage area. If a system with a 
TMPFS file system does not have adequate swap space, two problems can occur: 

■ The TMPFS file system can run out of space, just as a regular file system can fill up. 

■ Because TMPFS allocates swap space to save file data (if necessary), some programs 
may not be able to execute because there is not enough swap space. 

See Chapter 9, “Administering Systems,” for information about increasing swap space. 

The Loopback File System (LOFS) 

The LOFS file system lets you create a new virtual file system. You can access files using 
an alternative path name. For example, you can create a loopback mount of 
/onto/tmp/newroot. The entire file system hierarchy looks like it is duplicated under 
/tmp/newroot, including any file systems that were mounted from NFS servers. All files 
are accessible either with a path name starting from / or with a path name starting from 
/tmp/newroot until a different file system is mounted in /tmp/newroot or any of its 
subdirectories. 
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The Process File System (PROOFS) 

The PROCFS file system resides in memory. It contains a list of active processes, by 
number, in the /proc directory. Information in the /proc directory is used by commands 
such as ps. Debuggers and other development tools can also access the address space of 
the processes using file system calls. This example shows a partial listing of the contents 
of the /proc directory; 

castle% Is -1 /proc 
total 116 


dr-x- -X- -X 

5 root 

root 

736 Sep 

15 

09:00 

0 

dr-x--X- -X 

5 root 

root 

736 Sep 

15 

09:00 

1 

dr-x- -X--X 

5 root 

root 

736 Sep 

15 

09:01 

103 

dr-x- -X- -X 

5 root 

root 

736 Sep 

15 

09:01 

113 

dr-x--X--X 

5 root 

root 

736 Sep 

15 

09:01 

115 

dr-x- -X- -X 

5 root 

root 

736 Sep 

15 

09:01 

140 

dr-x--X- -X 

5 root 

root 

736 Sep 

15 

09:01 

145 

{Some processes removed 

from this example] 




dr-x- -X--X 

5 winsor 

staff 

736 

Sep 

15 

11:13 

545 

dr-x--X- -X 

5 winsor 

staff 

736 

Sep 

15 

11:46 

645 

dr-x- -X--X 

5 winsor 

staff 

736 

Sep 

15 

12:52 

679 

dr-x--x- -X 

5 root 

root 

736 

Sep 

15 

13:03 

717 

dr-x--X--X 

5 winsor 

staff 

736 

Sep 

15 

13:15 

806 

dr-x--X--X 

5 winsor 

staff 

736 

Sep 

15 

13:22 

808 

dr-x- -X- -X 

5 winsor 

staff 

736 

Sep 

15 

15:49 

876 

castle% 








oak% Is -1 /proc 







total 144944 








- rw. 

1 root 

root 

0 

Dec 

19 

15:45 

00000 

-rw. 

1 root 

root 

196608 

Dec 

19 

15:45 

00001 

-rw. 

1 root 

root 

0 

Dec 

19 

15:45 

00002 

- rw.- 

1 root 

root 

1028096 

Dec 

19 

15:46 

00073 

- rw.- 

1 root 

root 

1445888 

Dec 

19 

15:46 

00091 

-rw.- 

1 root 

root 

1142784 

Dec 

19 

15:46 

00093 

-rw. 

1 root 

root 

1142784 

Dec 

19 

15:46 

00095 

{Some processes removed 

from 

this example) 




- rw. 

1 ignatz 

staff 

1576960 

Dec 

19 

15:50 

00226 

-rw. 

1 ignatz 

staff 

192512 

Dec 

19 

15:51 

00236 

-rw. 

1 ignatz 

staff 

1269760 

Dec 

19 

15:52 

00240 

-rw. 

1 ignatz 

staff 

6090752 

Dec 

19 

15:52 

00241 

-rw. 

1 ignatz 

staff 

188416 

Dec 

19 

15:52 

00247 

- rw. 

1 ignatz 

staff 

2744320 

Dec 

19 

15:52 

00256 


castle% 

CAUTION! Do not delete the files in the /proc directory. Deleting processes from the 
/proc directory is not the recommended way to kill them. See Chapter 1 for information 
on how to kill a process. Remember, /proc files do not use disk space, so there is little rea¬ 
son to delete files from this directory. The /proc directory does not require any system ad¬ 
ministration. 

Enhancements to the /proc File System and Watchpoints 

The previous flat /proc file system has been restructured into a directory hierarchy that 
contains additional subdirectories for state information and control functions. It also 
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provides a watchpoint facility liiat is used to remap read/write permissions on the 
individual pages of the address space of a process. This facility has no restrictions and is 
multithread (MT) safe. 

The new /proc file structure provides complete binary compatibility with the old /proc 
interface except that the new watchpoint facility cannot be used with the old interface. 
Debugging tools have been modified to use the new /proc watchpoint facility, which 
means the entire watchpoint process is faster. 

The following restrictions have been removed when setting watchpoints using the dbx 
debugging tool: 

■ Setting watchpoints on local variables on the stack because of SPARC register 
windows 

■ Setting watchpoints on multithreaded processes 

For more information, refer to the proc(4), core(4), and adb(4) manual pages. 

Additional Virtual File Systems 

These additional types of virtual file systems are listed for your information. They do not 
require administration. 

■ FIFOS (first-in first-out) Named pipe files that give processes common access to 
data 

■ FDFS (file descriptors) Provides explicit names for opening files using file 
descriptors 

u NAMEFS Used mostly by streams for dynamic mounts of file descriptors on top of 
files 

■ SPECFS (special) Provides access to special character and block devices 

a SWAPFS File system used by the kernel when you create additional swap space 
with the mkf ile and swap commands 


The Default SunOS S.x File System 

The SunOS 5.x file system is hierarchical, starting with the root directory (/) and 
continuing downward through a number of directories. The SunOS 5.x system software 
installs a default set of directories and uses a set of conventions to group similar types of 
files together. Table 4-1 describes the default SunOS 5.x file system, and shows the type 
of each file system. 

The root (/) and /usr file systems are both needed to run a system. Some of the most 
basic commands from the /usr file system (such as mount) are included in the root file 
system so that they are available when the system boots up or is in single-user mode. 
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Table 4-1 

The Default SunOS 5.x File System 

File System 

File System Type 

Description 

/ 

UFS 

The top of the hierarchical file tree. The root directory contains the 
directories and files critical for system operation, such as the kernel 
(/ kernel/unix), the device drivers, and the programs used to start 
(boot) the system. It also contains the mount point directories where 
local and remote file systems can be attached to the file tree. 

/etc 

UFS 

Contains system-specific files used In system administration. 

/usr 

UFS 

Contains system files and directories that can be shared with other 
users. Files that run on only certain types of systems are in the /usr 
directory (for example, SPARC executables). Files (such as manual 
pages) that can be used on all types of systems are in /usr/share. 

/home 

NFS, UFS 

The mount point for the users’ home directories, which store users’ work 
files. By default, / home Is an automounted file system. On stand-alone 
systems, / home may be a uf s file system on a local disk slice. 

/var 

UFS 

Contains system files and directories that are likely to change or grow 
over the life of the local system. These include system logs, vi and ex 
backup flies, uucp files, and mail and calendar files. 

/opt 

NFS, UFS, S5FS 

Mount point for optional, third-party software. On some systems, /opt 
may be a uf s file system on a local disk slice. 

/tmp 

TMPFS 

Temporary files, cleared each time the system is booted or unmounted. 

/proc 

PROOFS 

Contains a list of active system processes, by number. 


The Virtual File System Table (/etc/vfstab} 



Each system has a virtual file system table, /etc /vf stab, that lists all the disk slices and 
file systems available to the system. The file system table also specifies the mount point 
and options for each file system. In the SunOS 4.x system software, the file system table 
is called /etc/fstab. The /etc/vfstab file replaces /etc/f stab and functions in a similar 
manner. The default file system configuration table (the /etc/vfstab file) depends on the 
selections made for each system when system software was installed. You should edit the 
/etc /vf stab file for each system to automatically mount local UFS file systems, essential 
NFS file systems, and any other appropriate file systems. 

This section describes the contents of the /etc/vfstab file and provides information on 
how to edit and use the file. The file system table is an ASCII file. Comment lines begin 




with #. This example shows an /etc /vf stab file for a system with two disks and two NFS 
file systems mounted: 



castle% more /etc/vfstab 


#device device. 

mount 


FS 

fsck 

mount 

mount 

#to mount to fsck 

ti 

point 


type 

pass 

at boot 

options 

#/dev/dsk/c1d0s2 /dev/rdsk/cld0s2 /usr 


ufs 

1 

yes 


fd - /dev/fd 

fd 

no 

- 




/proc - /proc 

proc 

no 

- 




/dev/dsk/c0t3d0s1 

- 

swap 

- 

no 

. 


/dev/dsk/c0t3d0s0 

/dev/rdsk/c0t3d0s0 

/ 

ufs 

1 

no 

swap - /tmp 

tmpfs 

yes 

. 





castle% 


Note that, for / and /usr, the automount field value is specified as no because these file 
systems are mounted as part of the boot sequence before the mountall command is run. 
If the automount field value is specified as yes, the mountall program redundantly (and 
unnecessarily) tries to mount these already mounted file systems. 

The file system table has seven fields, each separated by a tab, as described in Table 4-2. 


Table 4-2 Fields in the /etc/vfstab File 

Reid Description 

device to The device to mount can be 

mount 

• The block special device for local uf s file systems (for example, /dev/dsk/c0t0d0s0) 

• The resource name for remote file systems (for example, myserver: /export/home for an 
NFS file system) 

• The name of the slice on vi/hich to swap (for example, /dev/dsk/c0t3d0sl) 

• The /proc directory and proc file system type 

• CD-ROM as HSFS file system type 

• /dev/diskette as PCFS or UFS file system type. This field is also used to specify swap 
file systems. 

device to f sck The raw (character) special device that corresponds to the file system identified by the 

special field (for example, /dev/rdsk/c0t0d0s0). This determines the raw Interface that 
is used by fsck. Use a hyphen {-) when there Is no applicable device, such as for a 
read-only file system or a network-based file systerh. 

mount point The default mount point directory (for example,/usr for /dev/dsk/c0t0d0s6). 

FS type The type of file system Identified by the special field. 
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Table 4-2 Fields in the /etc/vfstab File (continued) 

Field Description 


fsck pass* The pass number used by fsck to decide whether to check a file system. When the field 

contains a hyphen (-), the file system is not checked. When the field contains a value of 1 or 
more, the file system Is checked; non-ufs file systems with a zero fsck pass are checked. 
For uf s file systems only, when the field contains a zero (0), the file system is not checked. 
When fsck is run on multiple ufs file systems that have fsck pass values greater than 1 
and the preen option (-o p) Is used, fsck automatically checks the file systems on 
different disks in parallel to maximize efficiency. When the field contains a value of 1, the file 
system is checked sequentially. Otherwise, the value of the pass number does not have any 
effect. 


mount at boot Indicate yes or no for whether the file system should be automatically mounted by mountall 
when the system is booted. Note that this field has nothing to do with the automounter 
software. 


mount options A list of comma-separated options (with no spaces) that are used in mounting the file 

system. Use a hyphen (-) to showiio options. Seethe mount_fi2e-system-typeflM) 
manual page for a list of the available optjons. 


*ln SunOS 5.x system software, fsck pass does not explicitly specify the order in which tile systems are 
checked as it did with SunOS 4.x system software. 


NOTE. You must have an entry in each field in the /etc/vfstab file. If there is no value 
for the field, be sure to enter a hyphen (-). 


Creation of an Entry in the File System Table 

Follow these steps to create an entry in the file system table: 



1. Become superuser. 

2. Edit the /etc/vfstab file using an editor such as vi. 

3. Add the entry, separating each field with white space (a space or a Tab). If a field has 
no entry, enter a hyphen (-). 

4. Save the changes. 

5. Check to be sure the mount point directory is present. If it’s not, create it by 
changing to the directory where you want to create the mount point, typing mkdir 
directory~naae, and pressing Return. 

6. Type mount mount-point and press Return, The entry is mounted. 

This example mounts the disk slice /dev/dsk/c0t3d0s7 as a ufs file system attached to the 

mount point directory /f ilesi with the default mount options (read/write). It specifies the 
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raw character device /clev/rdsl</c0t3d0s7 as the device to fsck. The fsck pass value of 2 
means that the file system will be checked, but not sequentially: 

fsck mount mount 

pass at boot options 

2 yes 

This example mounts the directory /export /man from the system oak as an NFS file system 
on mount point /usr/man. You do not specify a device to fsck or a fsck pass for NFS file 
systems. In this example, mount options are ro (read-only) and soft. For greater 
reliability, for read/write NFS file systems, specify the hard mount option (rw, hard): 

#device device mount FS fsck mount mount 

#to mount to fsck point type pass at boot options 

oak;/export/man - /usr/man nfs - yes ro,soft 

This example mounts a CD-ROM drive on a mount point named / hsf iies. CD-ROM files 
typically are read-only, so you specify ro for the mount options. Specify no for mount at 
boot because you are most likely to mount and unmount a CD-ROM from the command 
line or by using volume management. Because the hsf s is read-only, specify no device to 
fsck and no fsck pass number. 

#device device mount FS fsck mount mount 

#to mount to fsck point type pass at boot options 

/dev/dsk/c0t6d0s2 - /hsfiles hsfs - no ro 

This example mounts the diskette drive on a mount point named /pcf iles. Specify no for 
mount at boot because you are most likely to mount and unmount a diskette from the 
command line or by using volume management. Specify no to fsck or fsck pass, because 
the pcfs file system does not support fsck. 


#device 

device 

mount 

FS 

fsck 

mount 

mount 

#to mount 

to fsck 

point 

type 

pass 

at boot 

options 

/dev/diskette 

- 

/pcfiles 

pcfs 

- 

no 

rw 


This example mounts the root file system on a loopback mount point named /etc / 
newroot. Specify yes for automount, no device to fsck, and no fsck pass number. 
Loopback file systems must always be mounted after the file systems used to make up the 
loopback file system. Be sure that the loopback entry is the last entry in the /etc /vf stab 
file so that it follows the entries that it depends on: 

#device device mount FS fsck 

#to mount to fsck point type pass 

/ - /tmp/newroot lofs 

File System Administrative Commands 

This section lists the file system administrative commands and describes the syntax. 

Most file system administrative commands have a generic and a file system-specific 
component. Use the generic commands, which use the file system-specific component. 


mount mount 
at boot options 
yes' 


#device device mount FS 

#to mount to fsck point type 

# 

/dev/dsk/c0t3d0s7 /dev/rdsk/c0t3d0s7 /files! ufs 
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Table 4-3 lists the generic file system administrative commands, which are located in the 
/usr/sbin directory. Most of these commands also have file system-specific counterparts. 


Table 4-^ Generic File System Administrative Commands 


Command 

clri(lM) 

df{lM) 

ff(lM) 

fsck(lM) 

fsdb{lM) 

fstyp(liyi) 

labelit(lM) 

mkfstlM) 

mount(lM) 

inountall(lM) 

ncheck(llVI) 

uniount(lM) 

umountall(lM) 

volcopy(lM) 


Description 

Clears inodes. 

Reports the number of free disk blocks and files. 

Lists file names and statistics for a file system, 

Checks the Integrity of a file system and repairs any damage found. 

File system debugger. 

Determines the file system type. 

Lists or provides labels for file systems when copied to tape (for use by the volcopy 
command only). 

Makes a new file system. 

Mounts file systems and remote resources. 

Mounts all file systems specified in a file system table. 

Generates a list of path names with their i-numbers. 

Unmounts file systems and remote resources. 

Unmounts all file systems specified in a file system table. 

Makes an image copy of a file system. 


CAUTION! Do not use the file system-specific commands directly. If you specify an op¬ 
eration on a file system that does not support it, the generic command displays this error 
message: command; Operation not applicable for FSType type. 


Syntax of Generic Commands 

Most of the generic commands use this syntax; 

comand [-F type] [-V] [generic-options] [-o specific-options] 
[special I mount-point] [operands] 
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The options and arguments to the generic commands are shown in Table 4—i. 


Table 4-4 Generic File System Command Syntax 


Option Description 

- F type Specifies the type of file system, if you do not use this option, the command looks for 

an entry that matches special, raw device, or mount point in the /etc /vf stab file. 
Otherwise, the default is taken from the file /etc/default/fs for local file systems 
and from the file /etc /df s /f stypes for remote file systems. 

'V Echoes the completed command line. The echoed line may include additional 

information derived from /etc /vf stab. Use this option to verify and validate the 
command line. It does not execute the command. 

generic-options Options common to different types of file systems. 


-0 specif ic -options A list of options specific to the type of file system. The list must have the following 
format: -o followed by a space, followed by a series of keyword [=value ] pairs 
separated by commas with no Intervening spaces. 

special \ mount -point Identifies the file system. Name either the mount point or the special device file 
for the slice holding the file system. For some commands, the special file must be 
the raw (character) device, and for other commands it must be the block device. See 
Chapter 3, “Administering Devices,” for more information about disk device names. In 
some cases, this argument is used as a key to search the file /etc/vfstab for a 
matching entry from which to obtain other information. In most cases, this argument is 
required and must come immediately after specif ic -options. However, it is not 
required when you want a command to act on all the file systems (optionally limited by 
type) listed in the /etc/vfstab file. 

Operands Arguments specific to a type of file system. See the specific manual page of the 

command (for example, mkf s_ufs) for a detailed description. 


Manual Pages for Generic and Specific Commands 

Both the generic and specific commands have manual pages. The specific manual page is 
a continuation of the generic manual page. To look at a specific manual page, append an 
underscore and the file system type abbreviation to the generic command name. For 
example, to see the specific manual page for mounting an HSFS file system, type man 
raount_hsf s and press Return, LOFS, PCFS, and PROOFS do not have specific manual 
pages for the mount command. 

How Fiie System Commands Determine File System Type 

The generic file system commands determine the file system type by following this 
sequence; 
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1. From-F, if supplied. 

2. By matching a special device with an entry in /etc/vfstab (if special is supplied). 
For example, fsck first looks for a match against the fsck device field; if no match is 
found, it then checks against the special device field. 

3. By using the default specified in / etc /default /fs for local file systems and in 
/etc/dfs/fstypes for remote file systems. 

Type of File System 

If you want to determine the type of a file system, you can obtain the information from 
the same files that the generic commands use: 

■ The FS type field in the file system table (/etc/vfstab) 

■ The /etc /default/ fs file for local file systems 

■ The /etc /df s /f stypes file for remote file systems 

To find a file system’s type in the /etc/vfstab file, type grep momt-poJirt/etc/vfstab 
and press Return. Information for the mount point is displayed: 

drusilla% grep /trap /etc/vfstab 

swap - /trap tmpfs - yes 

drusilla% 

If vf stab does not have an entry for a file system, use one of the following procedures to 
determine the file system’s type. 

To identify a mounted file system’s type, type grep mount-point / etc / mnttab and press 
Return. Information on the mount point is displayed; 

drusilla% grep /home /etc/mnttab 

drusilla: (pid129) /tiorae nfs ro,ignore,niap=/etc/auto_honie,indirect,dev=21c0004 
693606637 

bigriver:/export/home/bigriver /tmp_nint/honie/bigriver nfs rw,dev=21c0005 

695409833 

drusilla% 

Or type mount and press Return. A list of the mounted file systems is displayed: 
drusilla% mount 

/ on /dev/dsk/c0t3d0s0 read/write on Tue Dec 24 12;29;22 1991 
/usr on /dev/dsk/c0t1d0s6 read/write on Tue Dec 24 12:29:22 1991 
/proc on /proc read/write on Tue Dec 24 12:29:22 1991 

/usr/man on swsvr4-50:/export/svr4/nian read/write/remote on Mon Dec 30 12:49:11 
1991 

/usr/openwin on swsvr4-50;/export/svr4/openwinV3 read/write/remote on Mon Dec 
30 \ 13:50:54 1991 

/trap on swap o on Wed Jan 8 13:38:45 1992 

/mnt on swsvr4-50:/export/svr4 read/write/remote on Fri Jan 10 15:51:23 1992 
/t(np__mnt/honie on bigriver:/export/home read/write/reraote on Tue Jan 14 \ 
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09:23:53 1992 
clrusilla% 

Or follow these steps; 

1. Type devnm mount-point and press Return. The raw device name is displayed. 

2. Become superuser. 

3. Type f styp /dev / rdsk f cntndnsn and press Return. The type of the file system is 
displayed: 

drusilla% devnm /usr 
/dev/dsk/c0t1d0s6 /usr 
drusilla% su 
Password: 

# fstyp /dev/rdsk/c0t3d0s0 
uf s 

# 


Making File Systems Available 

When you have created a file system, you need to make it available; you do this by 
mounting it. A mounted file system is attached to the system directory tree at the specified 
mount point and becomes available to the system. The root file system is always mounted. 
Any other file system can be connected or disconnected from the root file system. 

You can mount a local file system in these ways: 

■ By creating an entry in the / etc /vf stab (virtual file system table) file. 

The / etc/vf stab file contains a list of file systems that are automatically mounted 
when the system is booted in multiuser state. See the section “The Virtual File System 
Table (/etc /vfstab)” earlier in this chapter for a description of the /etc/vf stab file. 

■ From a command line using the mount command. 

File systems on disk shces must always be mounted on the server system and shared 
(exported) before other systems can access them. See “Sharing Files from a Server” later 
in this chapter for information about sharing file systems. When file systems are shared 
from a server, a client can mount them as NFS file systems in any of these three ways: 

■ By adding an entry to the /etc/vf stab file so that the file system is automatically 
mounted when the system is booted in multiuser state. 

■ By using the automount program to automatically mount or unmount the file system 
when a user changes into (mount) or out of (umount) the automounting directory. 

■ By using the mount command at a command line. 
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Understanding Mounting and Unmounting 

File systems can be attached to the hierarchy of directories available on a system. This 
process is called mounting. To mount a file system you need: 

■ To be superuser. 

■ A mount point on the local system. The mount point is a directory to which the 
mounted file system is attached. 

■ The resource name of the file system to be mounted (for example, / usr). 

As a general rule, local disk slices should always be included in the /etc /vf stab file. Any 
software from servers, such as CDE, OpenWindows, or manual pages, and home 
directories from a server can either be included in the /etc / vf stab file or be automounted, 
depending on the policy at your site. 

When you mount a file system, any files or directories that might be present in the mount 
point directory are unavailable as long as the file system is mounted. These files are not 
permanently affected by the mounting process and become available again when the file 
system is unmounted. However, mount directories usually are empty because you usually 
do not want to obscure existing files. 

The system tracks the mounted file systems in the /etc/mnttab (mount table) file. 
Whenever you mount or unmount a file system, the /etc /mnttab file is modified to show 
the list of currently mounted file systems. You can display the contents of the mount table 
using the cat or more conunand but you cannot edit the mount table as you would the 
/etc / vf stab file. Here is an example of a mount table file: 

cirusilla% more /etc/mnttab 

/dev/dsk/c0t3d0s0 / ufs nw,suid 693186371 

/dev/dsk/c0t1d0s6 /usr ufs rw,suid 693186371 

/proc /proc proc rw,suid 693186371 

swap /tmp tmpfs ,dev=0 693186373 

swsvr4-50;/export/svr4/openwinV3 /usr/openwin nfs rw,dev=21c0000 
693186443 

swsvr4-50:/export/svr4/man /usr/man nfs rw,dev=21c0001 

693186447 

drusilla:(pid127) /nse nfs 

ro,ignore,map=/etc/auto.nse,indirect,dev=21c0002 693186449 
drusilla:(pid127) /net nfs 

ro,ignore,map=-hosts,indirect,dev=21c0003 693186449 

drusilla:(pid127) /home nfs 

ro,ignore,map=/etc/auto_home,indirect,dev=21C0004 693186449 

bigriver:/export/home/bigriver /tmp_innt/home/bigriver nfs rw,dev=21c0005 

693186673 

drusilla% 

Using Mount and Unmount File System Commands 

Table 4-5 lists the commands in the /usr/sbin directory that you use to mount and 
unmount file systems. 
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Table 4-5 Commands for Mounting and Unmounting File Systems 


Command 

mount(llVI) 

iiiountall(llVl) 

ufnount(lM) 

umountall{lM) 


Description 

Mounts file systems and remote resources. 

Mounts all file systems specified In a file system table. 
Unmounts file systems and remote resources. 

Unmounts all file systems specified in a file system table. 



The mount commands will not mount a read/write file system that has inconsistencies. If 
you receive an error message from the mount or mountall command, you may need to 
check the file system. 

The umount command will not unmount a file system that is busy. A file system is 
considered busy if a user is in a directory in the file system or if a program has a file open 
in that file system. 



Table 4-6 describes the general mount options that you can specify with the -o option of 
the mount command. If you specify multiple options, separate them with commas (no 


spaces). For example, - o 

ro,nosuid. 

Table 4-6 

Commands for Mounting and Unmounting File Systems 

Option 

File System 

Description 

- rw 1 ro 

CacheFS, MFS, 
PCFS, UFS, S5FS 

Specifies read/write or read-only. If you do not specify this option, the 
default is read/write. 

-nosuid 

HSFS, NFS, UFS 

Prevents setuid execution and prevents devices on the file system 
from being opened. The default is to enable setuid execution and 
enable devices to be opened. 

-remount 

NFS, UFS, S5FS 

With rw, remounts a file system with read/write access. 

■f 

UFS, S5FS 

Fakes an entry in /etc/mnttab, but does not really mount any file 
systems. 

-n 

UFS, S5FS 

Mounts the file system without making an entry in /etc/mnttab. 

-bg 1 fg 

NFS 

If the first attempt fails, retries in the background (bg) or In the 
foreground (fg). The default is fg. 

-soft 1 hard 

NFS 

Specifies the procedure if the server does not respond, soft indicates 
that an error is returned, hard indicates that the retry request is 
continued until the server responds. The default is hard. 

--intr j nointr 

NFS 

Specifies whether keyboard interrupts can be used to kill a process 
hung while waiting for a response on hard-mounted file systems. The 
default is intr (Interrupts allowed). 

-retry=n 

NFS 

Retries the mount operations when it fails. 
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Table 4-6 Commands for Mounting and Unmounting Hie Systems (continued) 


Option RIe System 

-largefiles NFS 

■nolargefiles NFS 

-index filename NFS URL 


Description 

A file system mounted using this option may contain files larger than 
2 Gbyte, but it is not a requirement. This option is the default. 

Disables the -largefiles mount option to provide backward compatibility 
with previous file system behavior and enforcing the 2 Gbyte maximum 
file size limit. 

Automatically loads a file matching filename if it is found in a directory 
referenced by an NFS URL. 


-public NFS URL Resets the public file handle to the current directory to enable you to 

access an NFS URL even if the file system cannot be mounted in the 
usual way. 


Finding the Mounted Fiie Systems 

To display a list of f mounted file systems, type mount and press Return. All the file 
systems currently mounted are displayed: 

oak% mount 

/ on /dev/dsk/c0t0d0s0 read/write/setuid on Wed Oct 23 10:08:50 1991 
/usr on /dev/dsk/c0t0d0s6 read/write/setuid on Wed Oct 23 10:08:50 1991 
/proc on /proc read/write/setuid on Wed Oct 23 10:08:50 1991 
/tmp on swap on Wed Oct 23 10:08:52 1991 

/usr/openwin on cheers:/export/openwin hard/remote on-Wed Oct 23 
10:11:08 1991 

/home on blowup:(pid136) read only/intr/inap=auto.home/indirect on Wed Oct 23 
10:11:10 1991 

/vol on blowup:(pid136) read only/intr/map=auto.vol/indirect on Wed Oct 23 
10:11:10 1991 

/nse on blowup: (pid136) read only/intr/fiiap=/etc/auto.nse /indirect on Wed Oct 

23 10:11:10 1991 

oak% 

Mounting All File Systems in the /etc/vfstab File 

Follow these steps to mount all ffile systems in the /etc /vf stab file: 

1. Become superuser. 

2. Type mountall and press Return. 

All the file systems in the local /etc/vfstab file are mounted: 
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oak% su 
Password: 
mountall 
oak# 


Mounting All File Systems of a Specific Type 

Follow these steps to mount all f file systems of a specific type that are in the /etc /vf stab 
file. The most common file system types are ufs for local disk slices and NFS for network 
file systems. See “T^pes of File Systems” early in the chapter for a complete list of file 
system types. 


1. Become superuser. 

2. Type mountall -F filesystem-type and press Return. 

All the file systems of the type you specify that are in the local /etc / vf stab file are 
mounted. 

In this example, all NFS file systems are mounted: 


oak% su 
Password: 
mountall -F nfs 
oak# 



With the Solaris 2.6 release, the -largefiles mount option is used as the default for 
mounting UFS file systems. If you want to prevent users from mounting file systems that 
contain files larger than 2 Gbyte, you must explicitly use the nolargef lies mount option 
to disable the default behavior. 


Mounting a Single File System (mount) 

Follow these steps f to mount a single file system that has an entry in the /etc / vf stab file: 


1. Become superuser. 

2. Type mount mount’point and press Return. 

The file system is mounted, as shown in this example: 

oak% su 
Password: 

# mount /opt 

# 



Remounting a UFS File System Without Large Flies (mount) 

After you mount a fil fe system with the default largefiles mount option and large files 
have been created, you cannot remount the file system with the nolargef iles option until 
you remove any large files and run f sck to reset the state to nolargef iies. 

The nolargef iles mount option provides total compatibility with previous file system 
behavior and enforces the 2 Gbyte maximum file size limit. 
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Follow these steps to remount a UFS file system without large files: 

1. Become superuser. 

2. Type cd/Wiesysfew and press Return. 

3. Type find . -xdev -size +2000000 -exec is -1 {} \; and press Return. 

4. Remove any large files listed as the result of the find command. 

5. Type umount I filesystem and press Return. 

6. Typefsck /dev/rdsk/flfeKice'y7affeandpressRetum. 

7. Type mount -0 nolargefiles/dev/rdsk/atoK/ce-MTO and press Return. The file 
system is mounted. 

In the following example, the directory /f ilesl is searched for large files, unmounted, 
fscked, and mounted again with the nolargef iles option: 

oak% su 
Password: 

# cd /files! 

# find . -xdev -size +2000000 -exec Is -1 {} \; 

# umount /filesi 

# fsck /dev/rdsk/c0t3dos7 /filesi 

# mount -0 nolargefiles /dev/dsk/c0t3d0s7 /filesi 

Unmounting All Remote File Systems {umountall -Fnfs) 

Follow thes fe steps to unmount all remote file systems: 

1. Become superuser. 

2. Type umountall -F nfs and press Return. 

All the remote file systems in the local /etc/vf stab file are unmounted: 

oak% su 
Password: 
umountall -F nfs 

oak# 

CAUTIONl If you unmount all file systems (mountall without any arguments), the sys¬ 
tem may be unusable and you may need to reboot it. 

Unmounting Individual File Systems {umount) 

You cannot unmount a fdirectory that is being used. If you want to unmount a directory 
that is being used, all users must change out of the directory; 

1. Become superuser. 

2. If necessary, have users change out of the directory you want to unmount. 

3. Type umount mount-point and press Return. 
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The file system you specify is unmounted. 

In this example, the mount command is used first to find the mount point for the file system 
to be unmounted; 

oak% mount 

/ on /dev/dsk/c0t0d0s0 read/write/setuid on Wed Oct 23 10:08:50 1991 
/usr on /dev/dsk/c0t0d0s6 read/write/setuid on Wed Oct 23 10:08:50 1991 
/proc on /proc read/write/setuid on Wed Oct 23 10:08:50 1991 
/tmp on swap on Wed Oct 23 10:08:52 1991 

/usr/openwin on cheers:/export/openwin hard/remote on Wed Oct 23 
10:11:08 1991 

/home on blowup:(pid136) read only/intr/niap=auto.home/indirect on Wed Oct 23 
10:11:10 1991 

/vol on blowup:(pidi36) read only/intr/map=auto.vol/indirect on Wed Oct 23 
10:11:10 1991 

/nse on blowup: (pidi36) read only/intr/itiap=/etc/auto.nse /indirect on Wed Oct 23 
10:11:10 1991 
[41]oak% su 
Password: 

# cd / 

# umount /home 

# 

Automounting Directories 

You can mount file systems shared through NFS using a method called automounting. 

The AutoFS program runs in the background and mounts and unmounts remote 
directories as they are needed. Whenever a user on a client system running AutoFS 
accesses a remote file or directory available through the automounter, AutoFS mounts the 
file system on the user’s system. The remote file system remains mounted as long as the 
user remains in the directory and is using a file. If the remote file system is not accessed 
for a certain period of time, it is automatically unmounted. AutoFS mounts and unmounts 
file systems, as required without any intervention on the part of the user other than 
changing into or out of a directory. 

You can mount some file hierarchies with AutoFS and you can change others using the 
/etc /vf stab file and the mount command. A diskless machine must have entries for / 
(root), /usr, and /usr/ kvm in the /etc/vfstab file. 

CAUTION! Because shared file systems should always remain available, do not use Au¬ 
toFS to mount /usr/share. 

AutoFS works with the file systems specified in maps. These maps can be maintained as 
NIS, NIS+, or local files. The AutoFS maps can specify several remote locations for a 
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particular file. This way, if one of the servers is down, the automounter can try to mount 
from another machine. 

You can specify which servers are preferred for each resource in the maps by assigning 
each server a weighting factor. AutoFS starts automatically when a system enters run level 
3. You can also start it from a conunand hne. (Describing how to set up and administer the 
automounter is beyond the scope of this book.) By default, the SunOS 5.jc system software 
automounts /home. 


Sharing Files from a Server 

NFS is a distributed file system that can be used to tie together computers that are running 
different operating systems. For example, systems running DOS can share files with 
systems running UNIX. 

NFS makes the actual physical location of the file system irrelevant to the user. You can 
use NFS to allow users to see all the relevant files, regardless of location. Instead of 
placing copies of commonly used files on every system, NFS allows you to place one copy 
on one system’s disk and let all other systems access it across the network. Under NFS, 
remote file systems are virtually indistinguishable from local ones. 

A system becomes an NFS server if it has file systems to share or export over the network. 
A server keeps a list of currently exported file systems and their access restrictions (such 
as read/write or read-only). 

You may want to share resources, such as files, directories, or devices from one system on 
the network (typically, a server) with other systems. For example, you might want to share 
third-party applications or source files with users on other systems. 

When you share a resource, you make it available for mounting by remote systems. You 
can share a resource in these ways: 

■ Using the share or shareall command 

■ Adding an entry to the / etc /df s / df stab (distributed file system table) file 

The default /etc/dfs/d-f stab file shows the syntax and an example of entries: 
cinderelia% more /etc/dfs/dfstab 

# place share(1M) commands here for automatic execution 

# on entering init state 3. 

# 

# share [-F fstype] [ -o options] [-d ''<text>“] <pathname> [resource] 

# .e.g, 

# share -F nfs -o rw=engineering -d "home dirs" /export/home2 
share -F nfs /var/mail 

cinderella% 





Checking the Data Consistency of a File 
System [fsck) 

The UFS file system relies on an internal set of tables to keep track of inodes and used 
and available blocks. When these internal tables are not properly synchronized with data 
on a disk, inconsistencies result and file systems need to be repaired. 

File systems can be damaged or become inconsistent because of abrupt termination of the 
operating system in these ways: 

■ Power failure 

■ Accidental unplugging of the system 

■ Turning off the system without proper shutdown procedure 

■ A software error in the kernel 

File system cormption, though serious, is not common. When a system is booted, a file 
system consistency check is done automatically. Most of the time, this file system check 
repairs problems it encounters. 

File systems are checked with the fsck (file system check) program. The fsck command 
puts files and directories that are allocated but unreferenced in the lost+f ound directory in 
that file system. The inode number of each file is assigned as the name. If the lost+f ound 
directory does not exist, fsck creates it. If there is not enough space in the lost+f ound 
directory, fsck increases its size. 

You may need to interactively check file systems when: 

■ They cannot be mounted 

■ They develop problems while in use 

NOTE. When an in-use file system develops inconsistencies, strange error messages may 
be displayed in the console window, or the system may crash. Before using fsck, you may 
want to refer to the fs ckf iMJ manual page for more information. 

Finding Out Whether a File System Needs Checking 

Follow these steps to determine whether a file system needs to be checked: 

1, Become superuser. 

2. Type fsck -m /dev/rdsk/Cfft/7di7s/7 and press Return. 

The state flag in the superblock of the file system you specify is checked to determine 
whether the file system is clean or requires checking. 
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If you omit the device argument, all the UFS file systems listed in / etc / vf stab with a 
f sck pass value greater than 0 are checked. In this example, the first file system needs to 
be checked; the second file system does not: 

# fsck -in /dev/rdsk/c0t0d0s6 

** /dev/rdsk/c0t0d0s6 

ufs fsck: sanity check: /dev/rdsk/c0t0d0s6 needs checking 

# fsck -m /dev/rdsk/c0t0d0s7 
** /dev/rdsk/c0t0d0s7 

ufs fsck: sanity check: /dev/rdsk/c0t0d0s7 okay 

# 

Checking File Systems Interactively 

Follow these steps to check all file systems interactively: 

1. Become superuser. 

2. Unmount the file system. 

3. Type fsck and press Return. 

All file systems in the /etc /vfstab file with entries in the fsck pass field greater than 
zero are checked. You can also specify the mount point directory or /dev/rdsk/cntnd/isn 
as Mguments to fsck. Any inconsistency messages are displayed. 

In this example, /dev/rdsk/c0t0d0s6 is checked and the incorrect block count is corrected: 

# fsck /dev/rdsk/c0t0d0s6 

checkfilesys: /dev/rdsk/c0t0d0s6 
** Phase 1 - Check Block and Sizes 
INCORRECT BLOCK COUNT 1=2529 (6 should be 2) 

CORRECT? y 

** Phase 2 - Check Pathnames 
** Phase 3 - Check Connectivity 
** Phase 4 - Check Reference Counts 
** Phase 5 - Cylinder Groups 
Dynamic 4.3 FFFS 

929 files, 8928 used, 2851 free (75 frags, 347 blocks, 0.6% fragmentation) 
/dev/rdsk/c0t0d0s6 FILE SYSTEM STATE SET TO OKAY 

***** FILE SYSTEM WAS MODIFIED ***** 


Backing Up and Restoring File Systems 

Backing up files means making copies of them, usually on removable media, as a 
safeguard in case the originals get lost or damaged. Backup tapes are convenient for 
restoring accidentally deleted files, but they are essential in case of serious hardware 
failures or other disasters. 
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Backing up files is one of the most crucial system administration functions. You must plan 
and carry out a procedure for regularly scheduled backups of your file systems for three 
major reasons: 

■ To ensure file system integrity against a possible system crash 

■ To protect user files against accidental deletion 

■ To act as an important safeguard before reinstalling or upgrading a system 

When you back up file systems as scheduled, you have the assurance that you can restore 
anyone’s files to a reasonably recent state. In addition, you may want to back up file 
systems to transport them from one system to another or to archive them—saving files on 
a transportable media—so that you can remove or alter the files that remain on the system. 

When you plan a backup schedule, you need to consider: 

■ Which command to use to back up the file systems 

■ What media to use 

■ What backup schedule to use 

■ Which file systems to back up 

■ Which files are critical to users on this system 

■ Where the files are located—are they in a single file system? 

■ How often these files change 

■ How quickly you would need to restore these files in the event of damage or loss 

■ How often the relevant file systems can be unmounted so that they are available for 
backup 

Outlining possible backup strategies is beyond the scope of this book. See the 
uf sdump(lM) manual page for a suggested dump schedule. The discussions that follow 
describe how to use the uf sdump command to make backups and how to retrieve files using 
the ufsrestore command. 
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Table 4-7 lists the commands that you can use to back up and restore individual files and 
file systems. 


Table 4-7 Commands for Backing Up and Restoring Files and File Systems 


Task 


Command 


Back up and restore complete or 
individual file systems to a local or 
remote tape device 

Back up complete file systems for all 
systems on a network from a server 

Back up and restore an NIS+ master 
server 


ufsdump and ufsrestore. 

Solstice Backup software. Refer to the Solstice Backup 4.2 User Guide. 

nisbackup and nisrestore. Refer to the nisbackup and 
nisrestore manual pages. 



Specifying Tape Characteristics 

The ufsdump command uses a set of defaults when you do not specify any tape 
characteristics. You can specify tape cartridge (-c), density (-d), size (-s), and number of 
tracks (-t). Note that you can specify the options in any order as long as the arguments 
that follow match the order of the options. Table 4-8 provides some arguments to the 
ufsdump command that work well for different types of tape cartridges. 


Table 4-8 Tape Capacity Arguments to the ufsdump Command 


Medium 

Diskette 

60-Mbyte cartridge 
150-Mbyte cartridge 
1/2-inch tape 
2.3-Gbyte 8-mm tape 
5.0-Gbyte 8-mm tape 
5.0-Gbyte 4-mm tape 


Arguments 

ufsdump Ds 1422 
ufsdump cdst 1000 425 9 
ufsdump cdst 1000 700 18 
ufsdump dsb 1600 2300 126 
ufsdump dsb 54000 13000 126 
ufsdump dsb 54000 13000 126 
ufsdump b 96 


M Backing Up a File System Using QIC-150 Cartridge Tapes 
{ufsdump) 

To do a full backup on a file system, all users must be logged out and you must bring the 
system to single-user mode. (See “Tape Device Naming Conventions” in Chapter 3 if you 
need information about tape device names.) 
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You can dump or restore files from a remote drive by adding remote-host: to the front of 
the tape device name. Here is the syntax: 

remo te - t)os t; / de V / rmt / uni t 

For example, the device name for a remote tape drive /dev/rmt /©, on the system oak, 
would be oak: /dev/rmt/0. 

Follow these steps to do a level 0 (full) backup of a file system: 

1. Type in it s and press Return. The system is brought to single-user mode, which 
ensures that no users can change the file system you are backing up. 

2. Insert a tape cartridge in the QIC-150 tape drive. 

3. Type uf sduitip 0cuf /dev/rmt/owi# on tn 6n s/r and press Return. The 0 option 
specifies a level 0 (complete) dump. The c option specifies cartridge tape. The u 
option updates the dump record. The f option followed by the device name specifies 
the device file. Type the raw disk slice for the file system you want to back up, for 
example, C0t0d0s7 for /f ilesi. 

The following example does a level 0 dump of the c0todos7 slice: 

oak% su 
Password: 

# init s 

# ufsdurap 0cuf /dev/niit/0 C0t0d0s7 

DUMP: Date of this level 0 dump: Wed Mar 11 10:16:53 1992 
DUMP: Date of last level 0 dump: the epoch 

DUMP: Dumping /dev/rdsk/c0t3d0s7 (/export/home) to /dev/rmt/0 
DUMP: mapping (Pass I) tregular files] 

DUMP: mapping (Pass II) [directories] 

DUMP: estimated 956 blocks (478KB) 

DUMP: Writing 63 Kilobyte records 
DUMP: dumping (Pass III) [directories] 

DUMP: dumping (Pass IV) [regular files] 

DUMP: level 0 dump on Wed Mar 11 10:16:53 1992 
DUMP: 956 blocks (478KB) on 1 volume 
DUMP: DUMP IS DONE 

# 

4. If the dump requires more than one tape, the uf sdump command tells you when to 
change to a new tape. 

5. Label the tape with the command, file system, and date so that you can easily find 
the backup tape if you need to restore files. 

Accomplishing Incremental Backups 

You can specify different backup levels with the uf sdump command, making it possible to 
back up only those files that were changed since a previous backup at a lower level. 
Follow these steps to back up incremental changes since the last complete dump: 
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1. Bring the system to single-user mode. 

2. Become superuser. 

3. Put a tape into the tape drive. 

4. Type uf sdump//-P/ucf /dev/rrat/iwif /dev/rdsk/cyr 6a sy? and press Return. 
Type the level of the backup at the beginning of the ufsdump arguments. For 
example, for a level 9 backup, type 9ucf. 

5. Remove the tape from the tape drive and label it. 

Restoring a Backed-Up File System {ufsrestore) 

The ufsrestore command copies files from backups created using the ufsdump command 
into the current working directory. You can use ufsrestore to reload an entire file system 
hierarchy from a level 0 dump and incremental dumps that follow it, or to restore one or 
more single files from any dump tape. Files are restored with their original owner, last 
modification time, and mode (permissions). 

Before you start to restore files or file systems, you need to know: 

■ Which tapes (or diskettes) you need 

■ The raw device name for the file systems you want to back up 

■ The type of tape drive you will use 

■ The device name (local or remote) for the tape drive 

Determining WhicK Tapes to Use 

Before you can begin restoring file systems or files, you must determine which backup 
tapes you need. When restoring an entire file system, you always need the most recent 
level 0 backup tape. You also need the most recent incremental backup tapes made at each 
of the higher levels. Refer to the backup plan that you are using to determine the levels 
and number of tapes you need. For example, if you make level 0 and level 9 backups, you 
need the most recent level 0 and level 9 backup tapes made. 

Use the following steps to determine which tapes to use to restore individual files or file 
systems: 

1, Ask the user the date when the file or file system was lost, or the approximate date of 
the files to be recovered, 

2. Refer to your backup plan to find the date of the last backup that would have the file 
or file system on it. Note that you do not necessarily use the most recently backed up 
version of the file. To retrieve the most recent version of a file, work backward 
through the incremental backups from highest to lowest level and most recent to least 
recent. 
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3. If you have on-line archive files created using the uf sdump - a option, type 

ufsrestore ta archive-name I I filename (8/ and press Return. Be sure to use 

the complete path for the file-name{&). A list of the files and the media they are 
stored on is displayed. 

4. Retrieve the media containing the backups. Be aware of the storage organization of 
backup media at your site so that you can locate media that are months or years old. 

5. This step is optional. Insert media in the drive and type ufsrestore tf device-name 
/path/filenameis) and press Return. Be sure to use the complete path for the 
file-name{s). If a file is in the backup, its name and inode number are listed. 
Otherwise, a message says it is not on the volume. 

6. If you have multiple dump files on the same tape, you can use the - s n option to 
position the tape at the dump you want to use. For example, type ufsrestore xfs 
/dev/rmt0 5 and press Return to position the tape at the fifth dump and restore it. 

Restoring a Full Backup 

Follow these steps to restore a full backup of a file system using QIC-150 cartridge tape: 

CAUTION! This procedure completely destroys any data already in the file system by 

creating a new file system on the slice. 

1. Become superuser. 

2. Type init s and press Return. The system is brought to single-user mode, which 
ensures that no one is using the file system you are restoring. 

3. Type umount mount-point and press Return. The mount point you specify (for 
example,/filesi) is unmounted. 

4. Type newf s /dev/rdsk/cyrtyrd/rs^ and press Return. The raw device file for the disk 
slice (for example, /dev/rdsk /c0t0d0s7 for the /home slice) is wiped clean and the 
file system is rebuilt. 

5. Type mount /dev/dsk/cyrtyrdyrsy? and press Return. The file system, specified as the 
block file device (for example, /dev/dsk /C0t0d0s7 for /filesi), is remounted at the 
mount point you specify. 

6. Type cd mount-point and press Return. You are in the directory you want to restore. 

7. Insert the tape cartridge in the QIC-150 tape drive. 

8. Type ufsrestore rvf /dev / rmt / 0h and press Return. The file system is restored. 

In this example, the /filesi slice C0t0d0s7 is restored; 

oak% su 

Password: 

# init s 

# umount /filesi 

# newfs /dev/rdsk/c0t0d0s7 
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# mount /dev/dsk/c0t0d0s7 /filesi 

# cd /filesi 

# ufsrestore rvf /dev/rmt/0h 

# 

Restoring Files Interactively 

When restoring individual files and directories, it is a good idea to restore them to a 
temporary directory such as /var/tmp. After you verify them, you can move the files to 
their proper locations. You can restore individual files and directories to their original 
locations. If you do so, be sure you are not overwriting newer files with older versions 
from the backup tape. 

Follow these steps to restore files interactively; 

1. Become superuser. 

2. Write-protect the tape for safety, 

3. Put the backup tape in the tape drive. 

4. Type cd /var/tnip and press Return. If you want to restore the files to a different 
directory, substitute the directory name for / var/tmp in this step. 

5. Type ufsrestore if /dev/rmt/iwif and press Return. Some informational messages 
and the restore> prompt are displayed. 

6. Create a list of files to be restored: 

■ To list the contents of a directory, type is and press Return. 

■ To change directories, type cd directory-name and press Return, 

■ To add a directory or file name to the list of files to be restored, type add file‘name 
and press Return. 

■ To remove a directory or file name from the fist of files to be restored, type delete 

and press Return. 

■ To keep the mode of the current directory unchanged, type setmodes and press Re¬ 
turn. Then type n and press Return. 

7. When the list is complete, type extract and press Return. Then, ufsrestore asks you 
which volume number to use. 

8. Type the volume number and press Return. If you have only one volume, type 1 and 
press Return. The files and directories in the list are extracted and restored to the 
current working directory. 

9. Type quit and press Return. The shell prompt is displayed, 

10. Use the Is -i command to fist the restored files and directories. A list of files and 
directories is displayed. 
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11. Check the list to be sure all the files and directories you specified in the list have 
been restored. 

12. Use the mv command to move the files to the proper directories. 

In this example, the files backup .examples and junk are restored from the pubs directory: 

# Gd /var/tnip 

# ufsrestore if /dev/rint/0 
ufsrestore > Is 


lost+found/ pubs/ 


ufsrestore > 

cd pubs 




ufsrestore > 

Is 




./pubs: 
.Xauthority 


.login 

.profile 

backup.examples^ 

.Xdefaults 


.mtdeletelog 

.wastebasket/ 

core 

.cshrc 


.openwin-init 

Junk/ 

dead.letter 

.desksetdefaults 

.openwin-init.BAK 

backup.examples 

junk 


ufsrestore > add backup.examples 

ufsrestore > add junk 

ufsrestore > setmodes 

set owner/mode for [yn] n 

ufsrestore > extract 

You have not read any volumes yet. 

Unless you know which volume your file(s) are on you should start 
with the last volume and work towards the first. 

Specify next volume #: 1 


set owner/mode for ' 

.'? [yn] n 



ufsrestore 
# Is -1 
total 6 

> quit 




drwxrwxrwt 

3 sys 

sys 

512 Mar 11 10:36 

./ 

drwxrwxr-x 

18 root 

sys 

512 Mar 10 16:43 

../ 

drwxr-xr-x 

# pwd 
/var/tmp 

# cd pubs 

# Is 

2 pubs 

staff 

512 Mar 11 10:11 

pubs/ 

./ 

.. 

./ 

backup.examples 

junk 


# 

Restoring a Single File from a Backup Tape {ufsrestore) 

Follow these steps to restore a single file from a backup tape: 

1. Become superuser. 

2. Put the backup tape in the tape drive, 

3. Type cd /var/tmp and press Return. If you want to restore the files to a different 
directory, substitute the directory name for /var/tmp in this step. 
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4. Type uf srestore xf /dev/rmt/^wif file-name and press Return. The x option tells 
ufsrestore to copy specific files or directories in the filename argument. The 
message set owner/mode for [ yn] is displayed. 

5. Type n and press Return. Directory modes remain unchanged. 

6. Type the volume number where files are located and press Return. If there is only 
one volume, type 1 and press Return. The file is restored to the current working 
directory. 

7. Type Is -1 file-name and press Return. A listing for the file is displayed. 

8. Use the mv command to move the file to the proper directory. 

Creating Cache File Systems 

You can use the Cache File System (CacheFS) to improve NFS server performance and 
scalability by reducing server and network load. CacheFS is designed as a layered file 
system that enables the system to cache one file system on another. In an NFS 
environment, CacheFS increases the client per server ratio, reduces server and network 
loads, and improves performance for clients on slow links such as Point-to-Point Protocol 
(PPP). 

Understanding CacheFS 

With CacheFS you can enable a client system to cache a file system from a server. Initial 
access to the file system may seem slow, but subsequent uses of the same file by the user 
are faster. Typically you would cache an NFS or HSFS file system. You create cache file 
systems individually on each client system that needs improved NFS performance. 

NOTE. CacheFS does not support caching of the root (1) and jusr file systems. To 
cache these file systems, you must purchase the Solstice AutoClient product. 

1. Use the cf sadniin(lM) command to create a cache on a client system so that file 
systems you specify to be mounted in the cache can be accessed by the user locally 
instead of across the network. To prevent conflicts within the CacheFS software, 
after you have created the cache you should not perform any operations within the 
cache directory on the client system. 

2. Create a mount point where the file system from the server, called the back file 
system, is mounted. 

3. Mount a file system in a cache by using the mount command, adding an entry to the 
/etc/vf stab file, or using AutoFS to automount the file system. 

After you have completed setup of the CacheFS, files are dynamically placed in the cache 
as the user accesses them. 
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NOTE. You can mount only file systems that are shared. Refer to the share(7Mj manual 
page for more information or see section on page 145. 

Creating a Cache 

Follow these steps on a client system to create a cache: 

1. Decide what name you want to use for the cache directory. 

2. On the client system, become superuser. 

3. Type cf sadmin -c cscAe-ai/recf'G/y and press Return. 

In this example, a cache file system named cachetile is created in the /local directory: 
oak% su 

# cfsadmin -c /local/cachefile 

Specifying a Hie System to Be Mounted in the Cache 

You can specify file systems to be mounted in the cache so that users can locally access 
files in the cache file system you create. You can specify the file systems to be cached in 
three ways: 

■ Using the rrount(lM) command. When you use the mount command, the files must be 
mounted from the command line every time the system is rebooted. 

m Editing the /etc/vfstab file. When you add an entry to the /etc/vfstab file, the 
specified files are available for caching even when the system is rebooted. 

■ Using AutoFS. When you modify AutoFS maps, the specified files are available for 
caching even when the system is rebooted. 

Creating a Mount Point 

Regardless of the mechanism you choose to mount the file system, you need to create a 
mount point on the client system where CacheFS mounts the files. The mounted files are 
then cached in the cache directory that you created. 

Type mkdlr cache-directory and press Return. In this example, a mount point named 
/cachemount is created: 

# mkdir /docs-cachemount 

Specifying a File System (mount) You provide the following parameters for the 
mount command; 

■ The file system type of the back file system on the server: backf stype=/'sfji'/ie. 

■ The name of the cache directory: cache<lir=eeche-dlr 0 etory. 

■ The name of the back file system: back-filesystem. 

■ The mount point: 
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Follow these steps to mount a cache file system from a command line: 

1. On the client system, become superuser. 

2. Type mount -F cachets -o 

backfstype=/5»f>5oe, cB.c\\&^±.r=cache-dlreGtory[f options] back-file-systea 
mount-point and press Return. 

3. Type cachet sstat mount-point and press Return, The output from this command 
verifies that the cache you created was mounted. 

In this example, a mount point named /docs-cachemount is created and the NFS file 
system castle: /docs is mounted as a cached file system named /docs - cachemount in the 
cache named /local/cachfile: 

oak% su 

# mkdlr /docs-cachemount 

# mount -f cachets -o backtstype=nfs,cachedir=/Iocal/cachefile castle:/docs 
/docs-cachemount 

# cachetsstat /docs-cachemount 

/docs 

cache hit rate:100% (0 hits, 0 misses) 
consistency checks:1 (1 pass, 0 fail) 
modifies:0 
garbage collection:© 

If the file system was not mounted in the cache, an error message similar to the following 
is displayed: 

^ cachetsstat /docs-cachemount 

cachefsstat: /docs-cachemount not a cachefs mountpoint 

Specifying a File System {/etc/vfstab We) When you add a cache file system to 
the /etc/vfstab file on the client system, the back file system remains available to users 
as a cached file system. 

Follow these steps to mount a cache file system the /etc/vfstab file: 

1. On the client system, become superuser. 

2. Using an editor, add the following line to the /etc/vfstab file: 

I dev/dsk/ device-nam !dev/rdskI device-name /mount-point cachefs 2 yes - 

3. Type mount mount-point and press Return or reboot the system to mount the file 
system. 

In this example, the /usr/ local directory is mounted in the cache directory: 
/dev/disk/c0t1d0s0 /dev/rdsk/c0t1d0s0 /cache ufs 2 yes 

Specifying a File System (AutoFS Map) You add a cache file system to the 
auto^direct AutoFS map by specifying the -f stype=cachefs mount option. Note that 
you also specify the CacheFS mount options (for example, backf stype and cachedir). 
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Refer to the automount(lM) manual page for more information about automount maps or 
refer to the Solaris Advanced System Administrator's Guide available from Sun Microsys¬ 
tems Press. 

Follow these steps to specify a cache file system in the AutoFS map: 

1. Become superuser. 

2. Using an editor, add the following line to the auto_cfirect map: 

! mount-point -fstype=cachefs,cacheciir=/tffreic#'tfry, backfstype=nfs 

server: /file-system 

3. Reboot the system. 

4. Type cd files-system dsid press Return. 

5. Type Is files-system and press Return. Review the output of the Is command to 
verify that the entry was made correctly. 

Maintaining Caches 

After you set up cache file systems, you can perform the following maintenance tasks on 
them: 

■ Modify file systems in the cache by unmounting, deleting, re-creating, and remounting 
the cache 

■ Display cache information 

■ Check cache consistency 

■ Delete a file system from the cache 

■ Check cached file system integrity 

If you are using the /etc/vfstab file to mount file systems, you modify the cache by 
editing the file system options in the /etc/vfstab file. If you are using AutoFS, you 
modify the cache by editing the file system options in the AutoFS maps. 
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Table 4-9 lists the commands that you can use to perform cache maintenance. Refer to the 
appropriate manual page for more details. 


Table 4-9 Commands for Maintaining Cache File Systems 


Command 

cfsadmin 

cachefspack 

cachefslog 

cachefswssize 

cachefsstat 


Description 

Enables you to display information about cached file systems, delete a cached file 
system from a specified cache, and specify consistency checking on demand. See the 
cf sadmin(lM) manual page for more information. 

Enables you to create packing lists that specify individual files and directories that you 
want packed in the cache. A packing list contains files or directories to be packed in 
the cache. If a directory is in the packing list, all its subdirectories and files are also 
packed. See the cachef spack(lM) manual page for more information. 

Specifies the location of a CacheFS log file. This command also displays were 
statistics are currently being logged and enables you to halt logging. See the 
cachefslog(lM) manual page for more information. 

Interprets the log file to give a recommended cache size. See the 
cachef sswsize(lM) manual page for more Information. 

Displays statistical information about a specific file system or all cached file systems. 
The information provided in the output of this command is taken directly from the 
cache. See the cachef sstat(lM) manual page for more Information 


fsck -F cachefs 
{-m} {-0 noclean} 
cache-director'y 


Checks the ihtegrity of cached file systems and automatically corrects problems 
without requiring user Interaction. See the f sck_cachef s(lM) manual page for more 
information. 
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T his chapter contains information about checking on remote system 
status, logging in to a remote system, transferring files between systems, 
and administering the Network Information Service Plus (NIS+) data¬ 
bases. 

Checking on Remote System Status 

This section describes commands you use to find out the status of remote systems: rup, ping, 
and rpcinf 0 -d. 

Determining How Long a Remote System Has Been Up (rirp) 

To find out how long a system has been up and the load average, type rup syst^-aame and 
press Return. The host name, uptime, and load average are displayed: 

oak% rup ash 

ash up 59 days, 3:42, load average: 0.12, 0.12, 0,01 
oak% 

You can also display a list of all remote hosts in the subnet by tj^iing rup and pressing 
Return. If you display a list, you can use the options shown in Table 5-1 to sort the output. 


Tabl 0 5~1 

Options to the rup Command 

1 Option 

Description 

; -h 

1 

Sorts the display alphabetically by host name 

I 

' -1 

Sorts the display alphabetically by load average 

I -t ^ 

1 

Sorts the display by uptime 


In this example, the output is sorted alphabetically by host name: 
oak% rup -h 


ash 

up 

1 day, 

1:42, 

load average: 

0.00, 

0.31, 

0.34 

i 

elm 

up 

14 days, 

0 min. 

load average: 

0.07, 

0.01, 

0.00 

maple 

1 

up 

32 days. 

14:39, 

load average: 

0.21, 

0.05, 

0.00 

! 

1 oak 

up 

8 days, 

15:44, 

load average: 

0.-02, 

0.00, 

0.00 


oak% 





162 



Administering Network Services 


Determining Whether a Remote System Is Up 
{ping, rup, rpcinfo -p) 

Follow these steps to determine whether a remote system is up: 

1. Type ping system-name and press Return. The message system-name- is alive means 
the system is accessible over the network. The message ping: unknown host 
system-name means the system name is not known on the network. The message 
ping: no answer from system-name means the system is known on the network but 
is not up at this time. 

2. Type rup system-name and press Return. Information about how long the system has 
been up and the load average is displayed. 

3. Type rpcinfo -p system-name and press Return. Information about RPC services is 
displayed. 

4. Type rlogin system-name and press Return. You are logged in to the remote system. 

cinderella% ping drusilla 
drusilla is alive 
cinderella% rup drusilla 

drusilla up 3 days, 15:10 load average: 0.07, 0.08, 0.09 
cinderella% rpcinfo -p drusilla 


program 

vers 

proto 

port 

service 

100000 

3 

udp 

111 

portmapper 

100000 

2 

udp 

111 

portmapper 

100000 

3 

top 

111 

portmapper 

100000 

2 

top 

111 

portmapper 

100007 

3 

top 

1029 

ypbind 

100007 

3 

udp 

1025 

ypbind 

100021 

1 

top 

1030 

nlockmgr 

100021 

1 

udp 

1026 

nlockmgr 

100024 

1 

top 

1028 

status 

100024 

1 

udp 

1027 

status 

100021 

3 

top 

1030 

nlockmgr 

100021 

3 

udp 

1026 

nlockmgr 

100020 

2 

top 

4045 

llockmgr 

100020 

2 

udp 

4045 

llockmgr 

100021 

2 

top 

1030 

nlockmgr 

100021 

2 

udp 

1026 

nlockmgr 

100087 

10 

udp 

1031 

adm_agent 

100011 

1 

udp 

1034 

rquotad 

100002 

1 

udp 

1037 

rusersd 

100002 

2 

udp 

1037 

rusersd 

100012 

1 

udp 

1041 

sprayd 

100008 

1 

udp 

1043 

walld 

100001 

2 

udp 

1046 

rstatd 

100001 

3 

udp 

1046 

rstatd 

100001 

4 

udp 

1046 

rstatd 

100068 

2 

udp 

1049 

cmsd 

100068 

3 

udp 

1049 

cmsd 

100083 

1 

top 

4049 



cinderella% rlogin drusilla 
Password: 
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Last login: Mon Mar 2 10:31:55 from Cinderella 
drusilla% 

You can also use ping with a system’s IP address by typing ping ZP-ae/dress and pressing 
Return, The message iP-address is alive means the system is accessible over the 
network. The message ping: no answer from iP-address means the system is not 
available to the network. The message ping; unknown host IP-address means the system 
name is not known on the network: 

oak% ping 129.144.52.119 

129.144.52.119 is alive 

oak% ping 129.137.67.234 

ping: unknown host 129.137.67.234 

oak% ping 129.145.52.119 

ping; no answer from 129.145.52.119 

oak% 


Logging In to a Remote System (rlogiri) 

Follow these steps to log in to a remote system: 

1. Type rlogin ayatem-name and press Return. You may be prompted for a password. 

2. If you have a local account on that system, type your local password. Otherwise, type 
your NIS+ password. Unless you have a home directory that is accessible on the 
remote system (because it is local on that system, or because it is hard-mounted or 
automounted), you log in to the root (/) directory: 

oak% rlogin ash 
Password: 

No directory! Logging in with home=/ 

Last login: Tue Sep 17 13:54:28 from 129.144.52.119 

Sun Microsystems, Inc. SunOS 5.0 June 1992. 

ash% 


Transferring Files Between Systems {rep, ftp) 

If the automounter is set up for your site, you can transfer files between systems by using 
commands such as cp and mv. This section describes how to use the rep and ftp 
commands to transfer files between systems. 


Using the rep Command 

To transfer a file from a remote system to your system by using the remote copy 
command, type rep ayatem-namesaource-pathnama deatination and press Return. If you 
have proper security to access the remote system, the file is copied to the destination you 
specify. 
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In this example, the file quest is copied from the /tmp directory on the system ash to the 
current working directory on the system oak; 

oak% rep ash:/tmp/quest . 
oak% 

To transfer a file from a local system to a remote system, type rep pathname 
system-name: destination‘pathname and press Return. If you have proper security to 
access the remote system, the file is copied from the local system to the remote destination 
you specify. 

In this example, the file quest is copied from the current working directory on the system 
oak to the /tmp directory on the system ash; 

oak% rep quest ash:/tmp 
oak% 

If you want, you can rename the file as part of the destination path name. For example, to 
rename the file quest to questions and put it in the /tmp directory, type /tmp/questions 
as the destination path name. 

Using the File Transfer Program (ftp) 

Follow these steps to transfer files from your local system to a remote system by using the 
file transfer program. 

NOTE. You may need to have an account on each system and an entry in the I . rhosts 
file to use the file transfer program. Some systems allow read-only ftp access to anybody 
who logs in as anonymous and types a login name at the password prompt. 

If you have an NIS or an NIS+ accoimt, you can use your login name and network 
password to access a remote system by using ftp: 

1. Type ftp and press Return. The ftp> prompt is displayed. 

2. Type open remote-system‘name and press Return. System connection messages are 
displayed, and you are asked for a user name. 

3. Type the user name for your account on the remote system and press Return. If a 
password is required, you are asked to enter it. 

4. Type the password (if required) for your account on the remote system and press 
Return. A system login message and the f tp> prompt are displayed. 

5. Type bin to set binary format or asc to set ASCII format and press Return. The file 
type is set. 

6. Type put local-filename destination-filename and press Return. File transfer 
messages and the f tp> prompt are displayed. 

7. Type quit and press Return. A goodbye message and the command prompt are 
displayed. 
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The following example establishes an ftp connection from the system oak to the system 
elm, specifies ASCII format, puts the file quest from oak into the /tmp/quest directory on 
elm, and quits the session: 

oak% ftp 
ftp> open elm 
Connected to elm 

220 elm FTP server (UNIX(r} System V Release 4.0) ready. 

Name (elm:ignatz): ignatz 

331 Password required for ignatz. 

Password: 

230 User ignatz logged in. 
ftp> asc 

ftp> put quest /tmp/quest 
200 PORT command successful. 

150 ASCII data connection for /tmp/quest (129.144.52.119,1333). 

226 Transfer complete. 
ftp> quit 

221 Goodbye. 
oak% 

You can use the send command as an alternative to the put command. You can copy 
multiple files by using the mput command. There is no msend command. See the f tp(l) 
manual page for more information. 

NOTE. You must have an account on each system to use the file tranter program. 

If you have an NIS or an NIS+ account, you can use your login name and network 
password to access a remote system by using ftp. Follow these steps to transfer files from 
a remote system to your local system by using the file transfer program: 

1. Type ftp and press Return. The ftp> prompt is displayed. 

2. Type open remote-system-nme and press Return. System connection messages are 
displayed, and you are asked for a user name. 

3. Type the user name for your account on the remote system and press Return. If a 
password is required, you are asked to enter it. 

4. Type the password (if required) for your account on the remote system and press 
Return. A system login message and the f tp> prompt are displayed. 

5. Type bin to set binary format or asc to set ASCII format and press Return. The file 
type is set. 

6. Type get remote-filename destination-filename and press Return. File transfer 
messages and the ftp> prompt are displayed. 

7. Type quit and press Return. A goodbye message and the command prompt are 
displayed. 
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The following example establishes an ftp connection from the system oak to the system 
elm, specifies ASCII format, gets the file quest from elm, puts it into the /tmp/quest 
directory on oak, and quits the session: 

oak% ftp 
ftp> open elm 
Connected to elm 

220 elm FTP server (LINlX(r)System V Release 4.0) ready. 

Name (elm:ignatz): ignatz 

331 Password required for ignatz. 

Password: 

230 User ignatz logged in. 
ftp> asc 

ftp> get quest /tmp/quest 
200 PORT command successful. 

150 ASCII data connection for /tmp/quest (129.144.52.119,1333). 

226 Transfer complete. 

ftp> quit 

221 Goodbye. 
oak% 

NOTE. You can copy multiple files by using the mget command. See the ■ftp(l) manual 
page for more information. 


Administering NiS+ Databases {solstice) 

NIS+ provides a central store of information for network resources such as hosts, users, 
and mailboxes. NIS+ replaces NIS (Network Information Service) and provides these 
enhancements: 

■ An organizational framework that is simpler to administer in large companies. 

■ Improved security. 

■ Improved distribution time to propagate changes through the network. 

In addition, the Solaris 2.x environment provides a new name service switch file, 

/etc /nsswitch. conf , that lets you use several different network information services at 
once. The /etc/ nsswitch.conf file also lets you specify which service provides which 
type of information. In previous SunOS releases, selection of the name service was 
hard-coded into the services, which made it difficult to switch to a new name service. The 
/etc / nsswitch. conf file defines the order in which local files and network databases are 
searched for information. Describing how to set up NIS+ is beyond the scope of this book. 
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Solstice Host Manager 

In previous Solaris releases, you may have used Admintool to manage server and client 
support. In the Solaris 2.5 and later releases, you must use the Solstice Host Manager tool, 
which offers ease of use and provides support for the following name services: 

■ NIS+ tables 

■ NIS maps 

■ Local /etc files 

Because the Solstice Host Manager is sold as a separate product, describing how to use 
Host Manager is beyond the scope of this book. The information in the following sections 
is provided to help you evaluate whether the Solstice Host Manager product is useful in 
your system administration environment. 

Host Manager is a graphical user interface that enables you to add and maintain server and 
client support on a network. With a name service like NIS+, you can manage system 
information in a centralized manner so that important system information, such as host 
names, does not have to be duplicated on every system on the network. 

Host Manager enables you to: 

■ Add and modify support 

■ Update system types 

■ Convert system types 

■ Add and remove OS services 

■ Set up remote installation services 

■ Queue tasks 

■ Set root passwords 

■ Enable scripts 

■ Add a multihomed host 

The following sections provide a brief description of each of these capabilities. 

Add and Modify Support 

Host Manager enables you to add and modify support for the following Solaris system 
types: 

a Solaris AutoClient systems 
m Solaris diskless clients 
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■ Solaris stand-alone systems 

■ Solaris OS servers 

■ JavaStations (modify support only) 

Update System Types 

Host Manager initially marks the system types of previously added systems as generic. 
You can, however, choose Update System Types from the File menu to probe previously 
added systems and determine their system types automatically. If Host Manager cannot 
determine the system type (for example, if the system is not running the Solaris software), 
the systems remain marked as generic. 

NOTE. Systems running Solaris 2.5 or later must also have the Solstice AdminSuite soft¬ 
ware installed to enable Host Manager to automatically update the system type. 

The system type information is stored in the bootparams file in the local /etc files or a 
name service database. Host Manager either modifies an existing bootparams entry or adds 
a new one such as the following example for a Solaris stand-alone system named castle: 

castle: boottyp=;st 

Convert System Types 

Host Manager enables you to convert one system type to another. You can make the 
following conversions: 

■ Stand-alone system to an AutoClient system or OS server 
H Dataless system to an AutoClient system or OS server 

■ AutoClient system to a stand-alone system 

■ Generic system to a stand-alone or AutoClient system or to an OS server 

Add and Remove OS Services 

A Solaris OS server is a server that provides OS services to support client systems. By 
using Host Manager, you can add support for an OS server or convert a stand-alone 
system to an OS server. 

For each platform group and Solaris release that you want to support, you must add the 
particular OS service to the OS server. For example, if you want to support SPARC 
Sun4m systems mnning the Solaris 2.4 release, you must add Sun4m/Solaris 2.4 OS 
services to the OS server. You would also still need to add OS services to support SPARC 
Sun4c systems or x86 systems running the Solaris 2.4 release, because they are different 
platform groups. 

You must have access to the appropriate Solaris CD image to add OS services. 
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NOTE. Although Host Manager enables you to add support for diskless clients running 
the SunOS 4.x release, you cannot add SunOS 4.x OS services using Host Manager. You 
must use the instalMx commands to add OS services to an OS server, and then use Host 
Manager to add support for the SunOS 4.x client. 

You can remove OS services from an OS server by using Host Manager. For example, if 
you no longer want to support SPARC Sun4m systems running the Solaris 2.4 release, you 
can remove these OS services from the server by using Host manager. 

Set Up Remote Installation Services 

Host Manager enables you to set up systems to provide Solaris 1.x installation services 
for other systems on the network. You can set up the following types of installation 
services on a system; 

■ An install server — A system on the network that provides a Solaris CD image (either 
from a CD-ROM drive or the copy on the hard disk) for other systems to install from. 

■ A boot server — A system that provides boot information to other systems on the 
network. The boot server and the install server are usually the same system. 

■ A profile server — A system that contains JumpStart files for systems to perform a 
custom JumpStart installation. 

NOTE, A boot server and install server are typically the same system. However, if the 
system to be installed is on a different subnet than the install server, a boot server is re¬ 
quired on that subnet. 

Queue Tasks 

Host Manager enables you to queue tasks such as converting system types and adding OS 
services. Because these tasks may require several minutes to process, Host Manager 
enables you to set up tasks to be performed without requiring you to wait for each task to 
be completed. After setting up the tasks and choosing Save Changes from the File menu, 
you can monitor the progress of the tasks in a status bar located at the bottom of the 
window. 

Set Root Passwords 

You can now set the root password just as you do when setting the group or user 
password when adding a Solstice AutoClient or Solaris diskless client using Host 
Manager. 

Enable Scripts 

When you add a Solstice AutoClient by using Host Manager, you have the option to 
enable scripts that you have created to customize the addition or deletion of AutoClient 
systems. You can run these scripts on the server before or after you add the AutoClient to 
the server, or on the client before or after the cache is configured on the AutoClient. 
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Scripts must be located in the /opt/sUNWadmd/Scripts directory so that the AdminSuite 
software can read them. 

Adding a Multihomed Host 

Host Manager enables you to add a multihomed host alias for servers with multiple 
network interfaces. If a server has more than one IP address because it is on multiple 
networks, it is considered a multihomed host. With Host Manager, you can specify more 
than one IP address for a host to make it a multihomed host. 


Restrictions of Host Manager 

Host Manager has the following limitations; 

■ Host Manager cannot automatically recognize all previously added system types. 

■ Host Manager cannot add SunOS 4JC service to an OS server. 

■ Host Manager cannot provide remote installation services for SunOS 4jc systems. 

■ Host Manager does not enable you to install patches on existing clients and servers. 
However, if you have used the admclientpatch command to set up a patch spool 
directory, Host Manager references this spool directory and adds appropriate patches 
for all new hosts. 


Using NIS+ Tabies 

NIS+ tables correspond to NIS maps. The Solaris 2.x environment provides 16 types of 
tables (shown in Figure 5~1) that store the network information used by NIS+. 


Figure 5-1 

The 16 NIS+ tables. 



Each table stores a different type of information about users, workstations, or resources on 
the network. For instance, the Hosts table stores the hostname and network address of 
every workstation in the domain; the Bootparams table stores the location of the root, 
swap, and dump directories of the diskless clients in the domain. 
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Each domain may have its own set of these NIS+ tables, which store all the NIS+ 
information for that particular domain. Table 5-2 lists the 16 NIS+ tables and the 
information they store. 


Table 5-2 NIS+ Tables 


Table 

Hosts 

Bootparams 

Password 

Cred 

Group 

Netgroup 

Aliases 

Timezone 

Networks 

Netmasks 

Ethers 

Services 

Protocols 

RPC 

Auto_Home 
Auto_M aster 


Information in the Table 

Network address and hostname of every workstation in the domain 

Location of the root, swap, and dump partition of every diskless client in the 
domain 

Password information about every NIS+ principal in the domain, plus a pointer 
to the shadow file 

Credentials for principals who have permission to access the information or 
objects In the domain 

Password, group ID, and members of every group in the domain 

The netgroups to which workstations and users in the domain may belong 

Information about the aliases of workstations in the domain 

The time zone of every workstation in the domain 

The networks in the domain and their canonical names 

The networks in the domain and their associated netmasks 

The Ethernet address of every workstation In the domain 

The names of IP services used in the domain and their port numbers 

The list of IP protocols used in the domain 

The RPC program numbers for RPC services available in the domain 
The location of all users’ home directories in the domain 
Automounter map information 
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You can access information in NIS+ tables either by entry row or by column, as shown in 
Figure 5-2. 


Figure 5-2 

Entry row and columns in a 
table. 
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For example, if you want to find the network address of a workstation named drusiiia, 
you can ask a search program to look through the hostname column until it finds drusiiia, 
as shown in Figure 5-3. The program then searches the drusiiia entry row to find its 
network address, as shown in Figure 5-4. 


Figure 5-3 

Searching the Hostname 
column. 


Figure 5-4 

Finding a network. 


Hostname 

column 



oak 





grass 





violin 





' drusjlja , - 

' 

* 



























Address Hostname 

column column 



oak 




grass 




violin 



lati 

drusiiia 



•* -- 




























.Administering NIS+ Databases ( solstice) 


173 


You can use either NIS+ commands or Solstice AdminSuite to perform these types of 
searches for you. Table 5-3 lists the NIS+ administrative commands. 


Table 5-3 NIS+ Administraitive Commands 


Command 

nistbladtn 

nisgrep 

nismatch 

niscat 


Description 

Displays, adds, modifies, and deletes Information in an NIS+ table 
Searches for information in an NIS+ table 
Searches for Information in an NIS+ table 
Displays the entire contents of an NIS+ table 


See the manual pages for information about how to use these commands. 

NI5+ Security 

NIS+ uses a security authorization model that is similar to the UNIX file system model. It 
specifies that each item in the namespace as well as each record, each column, and each 
row has associated with it a set of access rights that are granted to three broad classes of 
principals: 

■ The owner of the item 

■ A group owner of the item 

■ All other principals 

The specific access rights are different from the traditional read, write, and execute rights 
of file systems because of the nature of information services. Refer to your system manual 
for more information about NIS+ security. 
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P RINTING IN THE SOLARIS 2.X ENVIRONMENT IS COMPLETELY DIFFERENT FROM 
printing with SunOS 4.x. Descriptions of printers are no longer stored in 
the /etc/printcap files. Instead, they are described by entries in the 
terminf 0 database. If you install the binary compatibility package (BCP), 
you can continue to use the ipr and Ipc printing commands. These commands do not, 
however, use the ipr printing system. Instead, they call the appropriate LP print service 
commands to perform the requested actions. 

The new printing service consists of the LP print service software, any print filters (programs 
that process data before printing) you may provide, and the hardware (the printer, 
workstation, and network connections). 

This chapter briefly describes the LP print service; lists the files, daemons, and logs used by 
the LP print service; provides steps for setting up print servers and clients; and describes the 
basic commands used for printing. 


What’S New in Printing 

The Solaris 2.6 print software provides better centralized print administration than the LP 
print software in previous Solaris releases. With the Solaris 2.6 release, you can easily set up 
and manage print clients by using the NIS or NIS+ name services. 

Solaris 2.6 print software features include: 

■ Redesign of print packages 

■ Print protocol adapter 

■ SunSoft print client 

■ Network printer support 

The Solaris 2.6 print software limitations include: 

■ No support for print servers defined as S5 (the System V print protocol) in previous 
Solaris 2.JC releases. 

■ No print filtering on print clients. 

Redesign of Print Packages 

The Solaris 2.6 print packages have been redesigned to provide greater flexibility and 
modularity of print software installation and to enable installation of a smaller print client 
footprint. 






With the Solaris 2.6 redesign, the default is to install all the packages. Print servers require 
installation of all packages, including both client and server. For print clients, you can 
choose to install only the print client packages. PostScript filter software is provided in its 
own print package. Table 6-1 describes the new set of print packages. 


Table 6-1 Solarit Packages 


Package 

Base Directory 

SUNWpcr 

root (/) 

SUNWpcu 

usr 

SUNWpsr 

root (/) 

SUNWpsu 

usr 

SUNWPSF 

usr 

SUNWscplp 

usr 


Description 

SunSoft Print—Client 
SunSoft Print—Client 
SunSoft Print—LP Server 
SunSoft Print—LP Server 
PostScript Filters 

SunSoft Print—Source Compatibility 


The following print packages have been removed from the Solaris 2.6 release: 

m SUNWlpr— ^LP print service (root) 
a suNWlpu —^LP print service—Client (usr) 
m suNWips —LP print service—Server (usr) 

Print commands from SUNWscpu have been moved into the SUNWscplp (SunSoft Print— 
Source Compatibility) package. 

Print Protocol Adaptor 

The Solaris 2.6 print protocol adapter replaces the Service Access Facility (S AF), the 
network listener, and ipNet on the inbound side of the LP spooler with a more modular 
and modem design. 

The print protocol adapter provides the following features: 

m Implementation of the complete BSD print protocol plus extended Solaris functionality. 

■ Multiple spooling systems can coexist on the same host and have access to the BSD 
print protocol. 

■ Third-party application developers can extend the print protocol adapter to support 
other printing protocols such as Apple and Novell, 

The new print protocol adapter is compatible with print clients set up in previous Solaris 
2.x releases if the BSD protocol was used to configure these clients. If the BSD protocol was 
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not used, you must modify the previous Solaris l.x print client configuration to use the BSD 
protocol by using Admintool, Solstice Printer Manager, or the Ipsystem command. 

SunSoft Print Client 

The SunSoft Print Client software is now bundled with the Solaris 2.6 release as packages 
SUNWpcr and suNWpcu. This software was previously released as an unbundled product. It 
was available on the Solaris Migration CD and as part of the AdminSuite lx suite of 
administration products. 

The SunSoft Print Client software uses an NTS map, an NIS+ table, or a single file to 
provide centralized client administration in the Solaris 2.6 release. Features of the Print 
Client software include: 

■ Replacing the /etc/ip directory structure with a configuration database that can be 
stored in a user file ($HOME/.printers), a system file (/etc/prints.conf), an NIS map 
(printers.conf .byname), or anNIS+FNS context. 

■ Using a more streamlined implementation providing reduced client overhead and 
quicker and more accurate responses to print status requests. 

H Using the ipset(lM) command to create the printers. conf file. 

■ Reducing the size of the package (183 Kbyte total) from previous Solaris releases. 

■ Providing interoperability with the BSD protocol available with SunOS 4.x, Solaris 2.x, 
HPUX, and other systems, as described in RFC-1179. 

Enhanced Network Printer Support 

The Solaris 2.6 print software provides better support for network printers than in 
previous Solaris releases. Features include: 

■ A new interface script, /usr/lib/lp/model/netstandard, which is specifically 
designed to support network printers. This script collects the spooler and print 
database information needed to perform network printing and passes it to the print 
output module. 

■ A new print output module, netpr, is called from the netstandard interface script to 
print the print job. It opens a network cormection to the printer, creates the correct 
protocol instructions, and sends the data to the printer. The netpr program currently 
supports two protocols: bsd print protocol and a TCP pass-through. 

■ New arguments to the Ipadmin -o command are used to specify destination name, 
protocol, and time-out values for the network printer. 

■ Solstice AdminSuite 2.3 Printer Manager can be used to set up and manage network 
printers. 
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Print Administration Tools in the Solaris 2.6 
Environment 

The Solaris 2.6 printing software provides an environment for setting up and managing 
client access to printers on a network. The Solaris 2.6 printing software contains the 
following components: 

■ SunSoft Print Client software, previously available only with the Solstice AdminSuite 
set of administration tools, enables you to make printers available to print clients by 
using a name service. 

■ Admintool, a graphical user interface used to manage printing on a local system, 

■ The LP print service commands, a command-line interface used to set up and manage 
printers that provide additional functionality not available with the other print 
management tools. 

■ The Solstice AdminSuite Print Manager, a graphical user interface used to manage 
printers in a name service environment, is available with the Solaris 2.6 server product. 

NOTE. If you do not use Solstice Printer Manager to set up and manage printing, you 
must use some combination of the other components to completely manage printing in the 
Solaris 2.6 environment. 

Table 6-2 summarizes the features of the Solaris 2.6 printing components. 


Table 6-2 Solaris 2.6 Printing Component Features 


Component 

Graphical User 
Interface 

Set Up Print 
Clients 

Manage Print 
Clients and 
Servers 

NIS OR NIS+ Support 

SunSoft Print 
Client 

No 

Yes 

No 

Yes 

Admintool 

Yes 

Yes 

Yes 

No 

LP commands 

No 

Yes 

Yes 

No 

Solstice 

AdminSuite 

Yes 

Yes 

Yes 

Yes 


Choosing a Method to Manage Printers 

The Solaris 2.6 print client software and the Printer Manager application in Solstice 
AdminSuite offer a graphical solution for setting up and managing printers on a network. 
The advantage of the Solaris 2.6 print client software is that it supports a name service 
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(NIS or NIS+), which enables you to centralize print administration for a network. You 
can also use the ipadmin command to configure printers on individual systems. 

Admintool provides an alternative method to install printers in the Solaris environment. 
Admintool is a graphical user interface for the LP print service commands that simplifies 
tasks for setting up and managing printers. 

You must run Admintool on the system the printer is connected to because you cannot 
make changes to a remote system by using Admintool. When you set up a printer, 
Admintool makes the appropriate changes in the /etc/printers .conf file and /etc/lp 
directories on the system, as required. You can use Admintool to set up a system as a print 
server or print client only if it is running the SunOS 5.^: operating system. 

Admintool should meet most of your needs for setting up printing services. However, if 
you have special needs, such as writing scripts, you may want to use the LP print service 
commands directly. 


Introducing the LP Print Service 

The LP print service performs the following functions: 

■ Administers files and schedules local print requests 

■ Schedules network requests 

■ Filters files (if necessary) so that they print properly 

■ Starts programs that interface with the printers 

■ Tracks the status of jobs 

■ Tracks forms mounted on the printer 

■ Tracks printwheels that are currently mounted 

■ Delivers alerts to mount new forms or different printwheels 

■ Delivers alerts about printing problems 
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Administering Files and Scheduling Print Requests 

The LP print service has a scheduler daemon, called ipsched. The scheduler daemon 
updates the LP system files with information about printer setup and configuration, as 
shown in Figure 6-1. 


Figure 6-1 

The Ipsched scheduler 
updates the LP system files. 


LP commands LP system files 




In the Solaris 2.6 release, all of the LP commands have been moved from /usr/bin into 
/usr/sbin except for enable and disable. The enable and disable commands are located 
in /usr/bin and /usr/lib/lp/iocal and are symbolically linked to the accept and reject 
commands. 


The Ipsched daemon also schedules all local print requests, as shown in Figure 6 - 2 , 
regardless of whether the requests are issued by users from an application or from the 
command line. In addition, the scheduler tracks the status of printers and filters. When a 
printer finishes printing a request, the scheduler schedules the next request, if there is one 
in the queue. 

Each print client and print server must have only one LP scheduler running. The scheduler 

is started when a system is booted (or enters run level 2) by the control script 

/etc /rc2. d/S80lp. Without rebooting the system, you can stop the scheduler with the 

/usr/sbin /ipshut command and restart the scheduler with the /usr/ lib/ ip/ ipsched 

command. The scheduler for each system manages its own print requests. It waits for 

requests issued by the LP commands and then handles the requests in an appropriate 

manner. 


Scheduling Network Print Requests 

Each print client and print server must have at least one (and maybe several) IpNet 
daemon. The IpNet daemon schedules network print requests. The ipNet daemon is also 
started when a system is booted. If you stop and restart the scheduler (using the Ipshut 
and Ipsched commands), the IpNet daemon is also stopped and restarted. 

Although the Service Access Facility— sacadm(lM), pmadm(lM) — is not part of the LP 
print system, the IpNet daemon needs a configured port monitor and registered listen 
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services to handle incoming network requests on each print server running SunOS 5.0 
system software. See Chapter 3, “Administering Devices,” for more information about the 
Service Access Facility. 



N OTE. The Solaris 2.6 release does not use the IpNet daemon to schedule network re¬ 
quests. Instead, network scheduling is handled by the inetd Internet services daemon. 

The inetd daemon listens for a request and starts in. ipd and then in. Ipd looks at the re¬ 
quest and loads bsd_lpsched. so. in. ipd passes the request through bsd_lpsched. so to 
Ipsched/or local printing. 


Figure 6-2 

The Ipsched scheduler 
schedules local print 
requests. 


Ipsched 

T 


Ipsched checks the systein files for: 

- Configuration Information 
~ Default printer 

- Filters 

- Forms 

- Classes 



Filtering Print Files 

Print filters are programs that convert the content of a file from one format to another so 
that it can be printed. In network printing, print filters process the file on the print client 
before it gets transmitted to the server. The LP print service uses filters to: 

■ Convert a file from one data format to another so that it can be printed properly on a 
specific type of printer 

H, Handle the special modes of printing that users may request using the -y option to the 
Ip command—for example, two-sided printing, landscape printing, draft- or 
letter-quality printing 

■ Detect printer faults and notify the LP print service of them so that the print service 
can deliver alerts 
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Not every print filter can perform all of these tasks. However, because each task is printer 
specific, it can be implemented separately. 

A print filter can be as simple or as complex as needed. SunOS 5.x system software 
provides print filters in the / usr/ lib/ Ip / postscript directory to cover most PostScript 
printing situations where the destination printer requires the data to be in PostScript 
format. You have to create and add filters to the system for non-PostScript printers. 


Starting the Printer Interface Program 

The LP print service uses a standard printer interface program to interact with other parts 
of the operating system to: 

■ Initialize the printer port, if necessary. The standard printer interface program uses the 
stty command to initialize the printer port. 

■ Initialize the printer. The standard printer interface program uses the terminfo database 
and the TERM shell variable to find the appropriate control sequences. 

■ Print a banner page, if necessary. 

■ Print the correct number of copies specified by the print request. 

The LP print service uses the standard interface program (found in the 
/usr/ lib/ ip/model directory) unless you specify a different one. You can create custom 
interface programs, but you must be careful that the custom program does not terminate 
the connection to the printer or interfere with proper printer initialization. 

Tracking the Status of Print Jobs 

The ipsched daemons on both the print server and the print client each keep a log of 
every print request that is processed and note any errors that occurred during the printing 
process. This log is kept in the / var/ ip/ logs/ ipsched file. Every night, the ip cron job 
renames / var/ip/ logs/ipsched to a new file ipsched, n and starts anew log file. If errors 
occur or jobs disappear from the print queue, you can use the log files to determine what 
ipsched has done with a print job. 


Tracking Forms 

The LP print service helps you track which forms are mounted on each printer and 
notifies you when it cannot find the description of how to print on a form. You are 
responsible for creating form descriptions and mounting and unmounting the paper form 
in each printer, either as part of setting up a printer or in response to alerts from the LP 
print service. 

Users can specify the form on which they want a job to print. You (root) can mount a 
specific form and then tell the LP print service that the form is available and on which 
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printer it is mounted. Alternatively, users can submit print requests specifying a particular 
form and whether the form is mounted. When the LP print service receives the request, it 
sends an alert message to the system administrator (root) requesting that the form be 
mounted. 

Tracking Printwheels 

The procedure for tracking printwheels is similar to the procedure for tracking forms. 
Some printers (usually letter-quality printers), such as daisy wheels or print balls, have 
removable print heads that provide a particular font or character set. A user can request a 
named character set. If that character set is not available, the LP print service notifies the 
system administrator (root) of the request. The job is stored in the print queue until the 
printwheel is changed. 

Receiving Printing Problem Alerts 

The LP print service performs sophisticated error checking. If a printing problem occurs, 
alerts are sent to the originator of a print request or to the system administrator, 
depending on the nature of the problem and what is required to fix it. Users are notified 
when a print request cannot be completed. Users can request notification by e-mail when 
a job is successfully completed. Administrators are alerted to problems with printers, and 
to requests for filters, forms, or character sets. 

For problems that require an administrator’s attention, the LP print service default is to 
write an alert message to the system administrator’s console window (that is, to the 
terminal on which root is logged in). 

As the system administrator, you can change the policy to receive alert messages via 
e-mail or a program of your choice. Or you can choose to receive no alerts when printing 
problems occur. 

Understanding the Structure of the LP Print Service 

The following sections explain the structure and directory hierarchy for the LP print 
service. The many files of the LP print service are distributed among seven directories, as 
shown in Table 6-3. 


Table 6-^ Directories for the LP Print Service 

Directory Description 

/usr/bin The Ip, Ipstat, enable, and disable commands 

/etc/Ip A hierarchy of LP configuration files 
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Table G-3 

Directories for the LP Print Service (continued) 

Directory 


Description 

/usr/share/lib 


The terminfo database directory 

/usr/sbin 


The LP commands 

/usr/lib/lp 


The LP daemons, directories for binary files and PostScript filters, and the model 
directory (which contains the standard printer interface program) 

/var/lp/logs 


The logs for LP activities 

Ipsched.n 


Messages from Ipsched 

/var/spool/lp 


The spooling directory where files are queued for printing 

requests.n* 


Information about completed print requests 


♦Moved from /var/lplogs in the Solaris 2.6 release. Note that the IpNet log was removed completely 
from the /var/lp/logs directory because the IpNet daemon is replaced by inetd in the Solaris 2.6 
release. 

User Commands 

The / usr/ bin directory contains the ip and Ipstat commands, with which users submit 
and monitor print requests. The directory also contains the enable and disable commands, 
with which printers are enabled and disabled. 

Users can customize their print requests by using options for the ip command, specifying 
forms, character sets, filters, titles, banners, and so forth. Table 6-4 summarizes the 
frequently used options for the ip conunand. These options can be used individually or 
combined in any order on the command line. When combining options, use a space 
between options and repeat the dash (-)• For example, the following command specifies a 
destination printer, requests e-mail notification, and prints six copies of a file: 

% Ip -d printer-name -m -ne filename 


Table 6-4 

Summary of Frequently Used Ip Command Options 

Option 

Name 

Description 

-d 

Destination 

Specifies a destination printer by name. 

-m 

Mall 

Sends e-mail to the user who submitted the print request when the file has been 
printed successfully. 

- n 

Number 

Specifies the number of copies to be printed. 

-t 

Title 

Specifies a title for a print request (printed only on the banner page). 

-0 nobanner Option 

Suppresses printing of the banner page for an individual request. 
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Table 6-4 Summary of Frequently Used tp Command Options (continued) 

- h Header Puts a header on each page of the print request, 

c Copy Copies the file before printing. 

- w Write Writes a message to root’s terminal when the file has printed successfully. 

See the lp(l) manual page for a complete list of options. 

LP Configuration Files 

The scheduler stores configuration information in LP configuration files located in the 
/etc / Ip directory. These configuration files serve the function of the /etc / printcap file 
in SunOS 4.1. You can check the contents of these files, but you should not edit them 
directly. The LP administrative commands provide input for the configuration files in the 
/etc / ip directory. The ipsched daemon administers and updates the configuration files. 
You should use the administrative commands any time you need to update any 
configuration file. Table 6-5 describes the contents of the /etc / ip directory. 


Table 6-5 

Contents of the /etc/lp Directory 

File 

Type 

Description 

alerts* 

1 

Directory 

Contains form, jobdone, printer, and sendMsg scripts 
for sending print system alerts to users. 

classes 

1 

Directory 

Contains files that identify classes provided by the 

Ipadmin - c command. 

i 

Directory 

Contains descriptions of existing filters. 

filter.table* 

File 

Print filter lookup table. 

: forms 

Directory 

Location to put files for each form. Initially, this directory is 
empty. 

interfaces 

1 

Directory 

Contains printer interface program files. 

i logs 

Link to /var/lp/logs 

Contains log files of printing activities. 

model 

Link to / us r/lib/Ip/model Contains the standard printer interface program. 

I printers 

Directory 

Contains directories for each (remote or local) printer 
setup. Each directory contains configuration Information 
and alert files for an individual printer. 

pwheels 

1 

Directory 

Contains printwheel or cartridge files. 


*New in Solaris 2.6. Note that the Systems ASCII file is no longer a part of the /etc/lp directory in the 
Solaris 2.6 printing environment 
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The printers directory has a subdirectory for each printer (local or remote) known to the 
system. This example shows the subdirectories for the printers pinecone and sparcl: 

%ls -1 /etc/lp/printers 

drwxrwxr-x 2 Ip Ip 512 Jan 23 23:53 pinecone 
drwxrwxr-x 2 Ip Ip 512 Jan 11 17:50 sparcl 

Within each of the printer-specific directories, the following files can describe the printer; 

■ alert. sh = Shell to execute in response to alerts 

■ alert. vars = Alert variables 

■ configuration = Configuration file 

■ users. deny = List of users to deny printer access 

■ comment = Printer description 

A typical configuration file for the printer pinecone, /etc / Ip / printers / 
pinecone/configuration, would look like this: 

Banner: on: Always 

Content types; PS 

Device: /dev/term/b 

Interface: /usr/lib/Ip/model/standard 

Printer type: PS 

Modules: default 

Printer Definitions 

The LP print service uses the terminf o database to initialize a local printer; to establish a 
selected page size, character pitch, line pitch, and character set; and to communicate the 
sequence of codes to a printer. The terminf o database directory is located in 
/usr/share/lib. 

Each printer is identified in the terminf o database with a short name. If necessary, you can 
add entries to the terminf o database, but it is a tedious and time-consuming process. 
Describing how to add entries to the terminfo database is beyond the scope of this book. 


Daemons and LP Internal Files 

The /usr/ lib/ ip directory contains daemons and files used by the LP print service, as 
described in Table 6-6. 


Table 6-6 Contents of the /usr/lib/lp Directory 

File Type Description 

bin Directory Contains files for generating printing alerts, slow filters, and queue management 

programs. 


local* 


Directory 


Contains LP executables for the local system. 
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Contents of the /usr/lib/Ip Directory (continued) 

File 

Type 

Description 

locale* 

Directory 

Contains locale information. 

Ipsched 

Daemon 

Manages scheduling of LP print requests. 

model 

Directory 

Contains the standard printer interface program. 

postscript 

Directory 

Contains all PostScript filter programs provided by the SunOS 5.0 LP print service. 
These filters come with descriptor files in the /etc/ Ip/ fd directory that tell the 
LP print service the characteristics of the filters and where to locate them. 


*New In Solaris 2.6. Note that the IpNet daemon and Ipdata executable files are no longer a part of the 
/usi'/lib/lp directory in the Solaris 2.6 printing environment. 


LP Administrative Commands 

The commands used to set up and administer the LP print service are in the / usr/sbin 
directory, as shown in Table 6-7. 


Table 6-7 The LP Commands in the/usr/sbin Directory 

Command Purpose 

accept / re j ect Accepts print requests into the printer’s queue or rejects print requests. 

Ipadmin Defines printer names, printer types, fiie content types, print classes, printer devices, and 

printer comments; removes printers or print classes; specifies fault recovery, Interface 
programs {either custom or standard), printing options, banner/no banner; mounts forms; 
mounts printwheels or cartridges; defines allow and deny user lists. 

Ipf ilter Adds, changes, deletes, and lists filters, 

Ipf orms Adds, changes, deletes, and lists forms. 

Ipmove Moves queued print requests from one printer to another 

Ipshut Halts the LP print service (the command ipsched, which starts the LP print service, is in the 

/usr/lib/Ip directory) 

Ipsystem Registers print servers and print clients with the LP print service 

Ipusers Sets queue priorities for users 


Log Files 

The LP print service maintains two sets of log files: a list of current requests that are in 
the print queue (/var/ spool/ip) and an ongoing history of print requests 
(/var/lp/logs/requests). 
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Print Queue Logs 

The scheduler for each system keeps a log of print requests in the directories 
/ var/spool/ Ip/requests / system and / var/ spool / Ip/ tmp / system. Each print request 
has two files (one in each directory) that contain information about the request. The 
information in the / var / spool / Ip / requests / system directory can be accessed only by 
root or Ip. The information in the / var / spool / ip / tmp / system directory can be 
accessed only by root, ip, or the user who submitted the request. 

The following example shows the contents of the / var / spool / Ip / tnip / pine directory. 

See Table 6-8 later in the chapter for an explanation of the LP requests log codes. 

pine% Is /var/spool/lp/tmp/pine 
20-0 21-0 
pine% cat 21-0 
C 1 

D slw2 

F /etc/default/login 
P 20 

t simple 
U winsor 
s 0x1000 

These files remain in their directories only as long as the print request is in the queue. 

Once the request is finished, the information in the files is combined and appended to the 
file / var /ip/logs/requests, which is described in the next section. 

Use the information in the / var / spool / Ip logs if you need to track the status of a print 
request that is currently in the queue. 

History Logs 

The LP print service records a history of printing services in three log files: ipNet, 
ipsched, and requests. These log files are located in the / var / Ip / logs directory. You can 
use the information in these logs to diagnose and troubleshoot printing problems. Here is 
an example of the contents of the / var / Ip / logs directory: 

# cd /var/lp/logs 

# Is 

Ipsched. 1 requests requests.2 

Ipsched Ipsched.2 requests. 1 

# 

The files with the . 1 and . 2 suffixes are copies of the previous day’s logs. Each day, the 
Ip cron job cleans out the ipsched and requests log files; it keeps copies for two days. 

The most important log file for troubleshooting is the ipsched log, which contains 
information about local printing requests. 

The requests log contains information about print requests that have completed and are no 
longer in the print queue. Once a request is finished printing, the information in the 
/ var/spool/ip log files is combined and appended to the /var/lp/logs/requests file. 
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The requests log has a simple structure, and you can extract data by using common UNIX 
shell commands. Requests are listed in the order they are printed and are separated by 
lines showing their request IDs. Each line below the separator line is marked with a single 
letter that identifies the kind of information contained in that line. Each letter is separated 
from the data by a single space. 

Here is an example of the contents of a requests log: 

# pwd 

/var/lp/logs 

# tail requests.2 

= S1W2-20, uid 200, gid 200, size 5123, Mon Nov 18 01:24:01 EST 1991 
z slw2 
Cl 

D slw2 
F /etc/motd 
P 20 
t simple 
U irving 
s 0x0100 

# 

Table 6-8 shows the codes in the LP requests log. 


Table &-8 Codes in the LP Requests Log 

Character Content of Line 

= The separator line. It contains the following items, separated by commas: the request ID, the user 

ID and group IDs of the user, the total number of bytes in the original (unfiltered) files, and the time 
when the request was queued. The user ID, group IDs, and file size are preceded by the words uid, 
gid, and size, respectively. 

C The number of copies printed. 

D The printer or class destination, or the word any. 

F The name of the file printed. The line is repeated for each file printed; files were printed in the 

order shown. 

f The name of the form used. 

H One of three types of special handling: resume, hold, and immediate. The only useful value found 

in this line will be immediate. 

N The type of alert used when the print request was successfully completed. The type is the letter M 

if the user was notified by e-mail or IV if the user was notified by a message to the terminal. 

0 The - o options. 

P The priority of the print request. 

p The list of pages printed. 

r This single-letter line is included if the user asks for raw processing of the files (the - r option of 

the Ip command). 
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Table &-8 Codes in the LP Requests Log (continued) 

Character Content of Line 

S The character set or printwheel (or cartridge} used. 

s The outcome of the request, shown as a combination of individual bits expressed in hexadecimal 

form. Although several bits are used internally by the print service, the most important bits are 
listed here: 

0x0004 Slow filtering finished successfully. 

0x0010 Printing finished successfully. 

0x0040 The request was canceled. 

0x0100 The request failed filtering or printing. 

T The title placed on the banner page, 

t The type of content found in the file(s). 

U The name of the user who submitted the print request. 

X The slow filter used for the print request. 

Y The list of special modes to give to the print filters used to print the request. 

z The printer used for the request. This printer differs from the destination (the D line) if the request 

was queued for any printer or a class of printers, or if the request was moved to another . 
destination. 


Spooling Directories 

Files queued for printing are stored in / van / spool / ip directory until they are printed. 
Table 6-9 shows the contents of the / var / spool / ip directory. 


Table 6-9 

File 

SCHEDLOCK 

admins 

bin 

fifos 

logs 

model 

requests 

system 


Contents of the /var/spool/lp Directory 


Type 

File 

Directory 

Directory 

Directory 

Link 

Link 

Directory 

Directory 


Description 

Lock file for the scheduler. Check for this file if the scheduler dies and won’t restart. 
Linked to /etc/Ip. 

Linked to /usr/lib/lp/bin. 

Contains pipes that convey networked print requests to and from the IpNet daemon. 
Linked to .. / Ip/ logs where completed print requests are logged. 

Linked to /usr/lib/lp/model. 

Contains a directory for each configured printer where print requests are logged until 
printed. Users cannot access this log. 

Contains a print status file for the system. 
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Contents of the /var/spool/lp Directory (continued) 


File 

temp 

tmp 



Type Description 

Link Linked to / var/spool/Ip/tmp/ printer-name, which contains the spooled 
requests. 

Directory Contains a directory for each configured printer where print requests are logged until 
printed. Changes to existing print requests are also recorded in this log. 


Using the SunSoft Print Client 

This section describes how the SunSoft print client works. The SunSoft print client is now 
provided as part of the Solaris 2.6 release. It was available previously only as an 
unbundled product. 

A system becomes a SunSoft print client when you install the SunSoft print client 
software and enable access to remote printers on the system. The SunSoft print client 
commands have the same names and produce the same output as the print commands of 
the previous Solaris releases. 

The Solaris 2,6 SunSoft print client commands use a greater number of options to locate 
printer configuration information than in the previous Solaris operating environment and 
the client communicates directly with the print server. 

The print command locates a printer and printer configuration information in the 
following sequence: 

1. It checks whether the user specified a destination printer name or printer class in one 
of the three valid styles. 

2. If the user did not specify a printer name or class in a valid style, the command 
checks the user’s printer or LPDEST environment variable for a default printer name. 

3. If neither environment variable for the default printer is defined, the command 
checks the . printers file in the user’s home directory for the _def ault printer alias. 

4. If the command does not find a _def ault printer alias in the . printers file, it then 
checks the SunSoft print client’s /etc/printers. conf file for configuration 
information. 

5. If the printer is not found in the /etc/printers. conf file, the command checks the 
name service (NIS or NIS+) if any. 

The client does not have a local print queue. The SunSoft print client sends its requests to 
the queue on the specified print server. The client writes the print request to a temporary 
spooling area only if the print server is not available or if an error occurs. This streamlined 
path to the server decreases the print client’s use of resources, reduces the chance for 
printing problems, and improves performance. 




Printer Configuration Resources 

This section describes the resources that the SunSoft print client commands use to locate 
printer names and printer configuration information. 

The SunSoft print client commands can use a name service, which is a shared network 
resource, for storing printer configuration information for all printers on the network. The 
name service (either NIS or NIS+) simplifies the maintenance of printer configuration 
information. When you add a printer in the name service, all SunSoft print clients on the 
network can access it. 

The SunSoft print client software locates printers by checking the following resources: 

■ Atomic, POSIX, or context-based printer name or class 

■ User’s PRINTER or lpdest environment variable for the default printer 

■ User’s . printers file for a printer alias 

■ SunSoft print client’s/etc/printers, conf file 

■ Name service (NIS or NIS+) 

Submitting Print Requests 

Users submit a print request from a SunSoft print client by using either the Ip or Ipr 
command. The user can specify a destination printer name or class in any of three styles; 

■ Atomic style, which is the print command and option followed by the printer name or 
class and the file name; ip -d printer-nam file-naae 

■ POSIX style, which is the print command and option followed by server: printer and 
the file name: Ipr -v server-name:printer-name file-name 

■ Context-based style, as defined in the Federated Naming Service Guide in the Solaris 
2.6 Software Developer AnswerBook: Ipr -d 

department-name/service -name/printer -name file -name 


Summary of the SunSoft Print Client Process 

The following list summarizes how the SunSoft print client process works: 

1. A user submits a print request from a SunSoft print client by using a SunSoft print 
client command. 

2. The print client command checks a hierarchy of print configuration resources to 
determine where to send the print request. 
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3. The print client command sends the print request directly to the appropriate print 
server. A print server can be any server that accepts BSD printing protocol, including 
SVR4 (LP) print servers and BSD print servers such as the SunOS 4.x BSD print 
server, 

4. The print server sends the print request to the appropriate printer. 

5. The print request is printed. 


Setting Up Printing Services 

You need to decide which systems will have local printers directly cabled to them and 
which systems will connect to printers over the network. The system that has the printer 
connected to it and makes the printer available to other systems is called a print server. 
The system that has its printing needs met by a print server is called a print client. 

Setting up printing services is comprises of three basic tasks: 

■ Setting up local printers 

■ Setting up print servers 

■ Setting up print clients 

You can have the following client/server combinations, as illustrated in Figure 6-3: 

■ SunOS 5.0 print clients with a SunOS 5.0 print server 

■ SunOS 5.0 and SunOS 4.1 print clients with a SunOS 5.0 print server 

■ SunOS 5.0 and SunOS 4.1 print clients with a SunOS 4.1 print server 

This section describes how to set up a SunOS 5.x print client. 

Setting Up a Local Printer by Using Admintool 

You can use Admintool to set up access to a printer or to configure a local printer. To use 
the Admintool: Printers windows, you must be a member of the UNIX sysadmin group 
(GID 14). 

To set up a print client, you need this information: 

■ Printer name 

■ Print server name 

■ Description 

■ Whether this is the default printer for the print client system 









Figure 6-3 

Print client/server 
configurations. 


4.x Client 


5.x Server 


4.x Server 


4.x Client 


5.x Client 


5.x Server 


Use the following steps to access a network printer: 


1. Type adinintool& and press Return to start Admintool (if necessary). 

2. From the Browse menu, choose Printers. The Admintool: Printers window is 
displayed, as shown in Figure 6-4. 


Figure 6-4 

The Admintool: Printers 
window. 
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3. From the Edit menu, choose Add and Access to Printer. The Admintool: Add Access 
To Printer window is displayed, as shown in Figure 6-5. 

Figure 6-5 

The Admintool: Add Access 
To Printer window. 


4. Enter the printer name, print server name, and description. 

5. If you want this printer to be the default printer, click on the Default Printer check 
box. 

6. Click on the OK button. The printer is configured and the printer information is 
added to the list in the Admintool: Printers window. 

To set up a local printer, you need this information: 

■ Printer name 

■ Print server name 

■ Description 

■ Printer port 
M Printer type 

■ File contents 

■ Type of fault notification 

■ Whether this is the default printer for the print client system 

■ Whether you want to always print a banner page 

■ Whether to specify a custom user access list 

Use the following steps to add a local printer: 

1. Type admintooia and press Return to start Admintool (if necessary). 

2. From the Browse menu, choose Printers. 
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3. From the Edit menu, choose Add and Local Printer. The Admintool; Add Local 
Printer window is displayed, as shown in Figure 6-6. 


Figure 6-6 

The Admintool: Add Local 
Printer window. 



4. Enter the printer name and description. 

5. Choose the printer port, printer type, file contents, and fault notification. 

6. If you want to specify this printer as the default printer, click on the Default Printer 
check box. 

7. If you want to always print the banner, click on the Always Print Banner check box. 

8. (If necessary) modify the user access list. 

9. When you have completed all of the setup, click on the OK button. The printer is 
configured and the printer information is added to the list in the Admintool: Printers 
window, as shown in Figure 6-7. 



Setting Up a Print Server (Solaris 2.x) 

This section describes how to add a network printer by using LP commands. 
You need this information to set up a Solaris 2.x print server: 


■ Printer name. 


■ Server name. 
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The Admintool: Printers 
window. 
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■ Network printer access name, sometimes qualified by a port name. 

■ IP address for the printer. 

■ Protocol. The print subsystem uses the BSD print protocol and raw TCP to 
communicate with the printer. In general, the TCP protocol is more generic. The 
printer vendor documentation will provide the information about which protocol to use. 

■ Timeout value. The timeout option specifies the amount of time in seconds to wait 
between successive attempts to connect to the printer. The default is 10 seconds. Some 
printers have a long warm-up time and a longer timeout is advised. 

■ Printer type. The default is PostScript. 

■ File content type. The default is PostScript 

■ Fault notification policy for this print server. The default is write to superuser. 

Follow these steps to set up a print server: 

1. Connect the printer to the network and turn on the power to the printer. Consult the 
printer vendor installation documentation for information about hardware switches 
and cabling requirements. Get an IP address and select a name for the printer node. 
These procedures are equivalent to those for adding any new node to the network. 

2. Become superuser. 

3. Type Ipadniin printer-name -v /dev/null and press Return. This step defines the 
printer name and the port device the printer uses. The device to use is /dev/null. 

4. Type Ipadmin printer-name -i /usr/lib/lp/raodel/netstandard and press 
Return. This step defines the interface script the printer uses. 

5. Type Ipadmin printer-name -o f^e5X=accesa-name:port -o protocol=protoeoJ 
-o timeout=Kflitfe and press Return. This step sets the printer destination, protocol, 
and timeout values. 

6. Type ipadmin printer-namecontent-type printer-type and press Return. 

This step specifies the file content type and the printer type. 

7. Typecd /etc/lp/fd and press Return. You are in the filter directory. 
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8. Type for filter in *. fd; do and press Return. 

9. At the > prompt, type name*'basename $filter .fd'and press Return. 

10. At the > prompt, type Ipfilter -f $name -F $filter and press Return. 

11. At the > prompt, type done and press Return. You have installed filters. 

12. Type accept printer-aam and press Return. The printer is able to accept requests. 

13. Type enable printer-name and press Return. The printer is enabled to print the 
requests. 

14. Type Ipstat printer-name and press Return. This step verifies that the printer is 
configured correctly. 

15. Set up any print clients that you want to be able to access this printer. 

The following example sets up a print server by using the following information: 

■ Printer name: seachild 

■ Network printer access name: nimquat: 9100 

■ Protocol: tcp 

■ Timeout: 5 

■ ■Interface: /usr/lib/lp/model/netstandard 

■ Printer type: PS 

■ Content types: postscript 

■ Device: /dev/null 

# Ipadmin -p seachild -v /dev/null 

# Ipadmin -p seachild -i /usr/lib/lp/model/netstandard 

# Ipadmin -p seachild -o dest:nimquat:9100 -o protocol=tcp -o timeout=5 

# Ipadmin -p seachild -I postscript -T PS 

# cd /etc/lp/fd 

# for filter in *.fd;do 

> name='basename $filter .fd' 

> Ipfilter -f $name -F $fliter 

> done 

# accept castle 

destination ' 'castle' ' now accepting requests 

# enable castle 

printer ’ 'castle' ' now enabled 

# Ipadmin -p castle -D "PostScript printer" 

# Ipstat -p castle 

printer castle is idle, enabled since Mon Sep 15 08:45 1997. 
available 
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Setting Up a PostScript Print Client by Using LP Commands 

This section describes how to set up a SunOS 5.0 print client to print on a SunOS 4.x 
print server that has a PostScript printer installed. You must complete the following tasks 
so the print client can use the printer connected to the print server: 

■ Identify the printer and server system to which the printer is connected. 

■ Define the characteristics of the printer. 

■ Set up the print filters. 

You must have a network that enables access between systems to set up print clients. If 
your network is running NIS or NIS+, follow the appropriate procedures for enabling 
access between systems. If your network is not running NIS or NIS+, you must include 
the Internet address and system name for each print client in the / etc / hosts file on the 
print server. You must also include the Internet address and system name of the print 
server in the /etc/hosts file of each print client system. 

Before you start, you need superuser privileges on the print client system. You also need 
the name of the printer and the name of the print server system. You do not need to specify 
a printer type or file content type for a printer client. If no printer type is specified, the 
default is unknown. If no file content type is specified, the default is any, which allows both 
PostScript and ASCII files to be printed on a PostScript printer. 

To set up a PostScript print client: 

1. Become superuser on the print client system. 

2. Type ipsystem -t bsd server-system-name and press Return. The print server 
system is identified as a BSD (SunOS 4.x) system. 

3. Type Ipadtnin -’p printer-name -s server-system-name and press Return. The 
printer and the server system name are registered with the client LP print service. 

4. Type cd /etc/Ip/fd and press Return. 

5. Type Ipfliter -f download ‘F download.fd and press Return. 

6. Type Ipfilter -f dpost -F dpost.fd and press Return. 

7. Type Ipf liter -f postlo -F post io.fd and press Return. 

8. Type Ipf liter -f postior -F postior.fd and press Return. 

9. Type Ipfilter -f postprint -F postprint.fd and press Return. 

10. Type Ipfilter -f postreverse -F post re verse.fd and press Return. The 
PostScript filters are installed. 

11. Type accept printer-name and press Return. The printer is now ready to begin 
accepting (queuing) print requests. 







200 


Administering Printing 


12. Type enable printer-name and press Return. The printer is now ready to process 
print requests in the print queue. 

13. (This step is optional but recommended.) Type Ipadmin -<1 printer-name and press 
Return. The printer you specify is established as the default printer for the system. 
You should define a default printer even if there is only one printer configured for a 
system. 

14. Type ipstat -t and press Return. Check the messages displayed to verify that the 
printer is accepted and enabled. 

15. Type Ip file-name and press Return. If you have not specified a default printer, type 
Ip -d printer-name file-name and press Return. The file you choose is sent to the 
printer. 

If you want to set up SunOS 5.0 print clients and print servers in addition to setting up the 
LP print system, you must also configure the port monitors using the Service Access 
Facility. See Chapter 3, “Administering Devices,” for information on how to set up the 
port monitors. If you use the Solaris 2.1 Printer Manager, the port monitors are configured 
for you automatically. See Appendix A, “Major Differences: SunOS 4.x Versus SunOS 5.x 
Operating Systems,” for information about the Printer Manager. To set up a SunOS 5.0 
print client, in place of step 2 in the procedure described above, type ipsystem 
server-system-name and press Return. The print server system is identified as a SunOS 
5.x system. 


Using Printing Commands 

The following sections describe how to use ip to submit requests from a command line. 
When a request is made, the LP print service places it in the queue for the printer, 
displays the request ID number, and then redisplays the shell prompt. The ip command 
has many options that can modify the printing process, as summarized in Table 6-4 
earlier in the chapter. For a complete list of options, see the ip(l) manual page. 

Printing to the Defauit Printer 

When the LP print service is set up with a default printer, users can submit print requests 
without typing the name of the printer. TVpe Ip file-name and press Return. The file 
specified is placed in the print queue of the default printer, and the request ID is displayed. 

The following example will print the /etc/passwd file: 

pine% Ip /etc/passwd 

request id is pinecone-8 (1 file) 

pine% 
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Printing to a Printer by Name 

Whether or not a default printer has been designated for your system, you can submit 
print requests to any printer that is configured for your system. To submit a print request 
to an individual printer, type Ip -d prlntBr^naae file-name and press Return. The file 
specified is placed in the print queue of the destination printer, and the request ID is 
displayed. 

The following example will print the /etc / passwd file on the printer acorn: 

pine% Ip -d acorn /etc/passwd 
request id is acorn-Q (1 file) 
pine% 

If you submit a request to a printer that is not configured on your system, an information 
message is displayed, as shown in this example: 

pine% Ip -d thorn /etc/passwd 

UX:lp: ERROR: Destination “thorn" is unknown to the 
LP print service. 

pine% 


Requesting Notification When a File Is Done Printing 

When you submit a large file to be printed, you may want the LP print service to notify you 
when printing is complete. You can request that the LP print service notify you either via an 
e-mail message or via a message to your console window. 

To request e-mail notification, use the -m option when you submit the print request. Type 
Ip "tn -Mare and press Return. 

To request that a message be written to your console window, use the -w option when you 
submit the print request. TVpe Ip -w file-name and press Return. 


Printing Multiple Copies 

You can print more than one copy of a file. When you request more than one copy, the file 
is printed the number of times you specify by using the -n option to the ip command. The 
print request is considered as one print job, and only one header page is printed. To 
request multiple copies, type Ip fWe -mm and press Return. 

The following example will print four copies of the / etc / passwd file: 

pine% Ip ■n4 /etc/passwd 

request id is pinecone-9 (1 file) 

pine% 
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Determining Printer Status 

Use the Ipstat command to find out about the status of the LP print service. You can 
check on the status of your own jobs in the print queue, determine which printers are 
available for you to use, or determine request IDs of your jobs if you want to cancel them. 

The Status of Your Print Requests 

To find out the status of your own spooled print requests, type Ipstat and press Return. A 
list of the files that you have submitted for printing is displayed. 

In this example, on the system pine, one file is queued for printing to the printer pinecone: 
pine% Ipstat 

pinecone-10 fred 1261 Mar 12 17:34 on pine 

pine% 

The Ipstat command displays one line for each print job, showing the request ID and 
followed by the user who spooled the request, the output size in bytes, and the date and 
time of the request. 

Availability of Printers 

To find out which printers are configured on your system, type Ipstat -s and press 
Return. The status of the scheduler is displayed, followed by the default destination and a 
list of the systems and printers that are available to you. 

In this example, on the system elm, the scheduler is running, the default printer is 
pinecone, and two network printers are available: 

elm% Ipstat -s 

scheduler is running 

system default destination: pinecone 

system for pinecone: pine 

system for acorn: oak 

elm% 


Display of All Status information 

The -t option for Ipstat gives you a short listing of the status of the LP print service. To 
display a short listing of all status information, type Ipstat -t and press Return. All 
available status information is displayed. 

In this example, there are no jobs in the print queue. When files are spooled for printing, 
the status of those print requests is also displayed: 

elm% Ipstat -t 
scheduler is running 
system default destination: tom 
system for slw2; bertha 
system for slwl; bertha 
device for tom: /dev/term/b 

slw2 accepting requests since Mon May 11 11:01:54 EOT 1992 
slwl accepting requests since Wed May 27 16:26:38 EOT 1992 
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tom accepting requests since Wed Jun 3 14:25:41 EDT 1992 
printer slw2 is idle, enabled since Mon May 11 11:01:55 EDT 1992. available, 
printer slwl is idle, enabled since Wed May 27 16:26:38 EDT 1992. available, 
printer tom is idle, enabled since Wed Jun 3 14:25:41 EDT 1992. available. 


character 

set 

usascii 

character 

set 

english 

character 

set 

finnish 

character 

set 

Japanese 

character 

set 

norwegian 

character 

set 

Swedish 

character 

set 

germanic 

character 

set 

french 

character 

set 

canadian_french 

character 

set 

italian 

character 

set 

Spanish 

character 

set 

line 

character 

set 

security 

character 

set 

ebcdic 

character 

set 

apl 

character 

elm% 

set 

mosaic 


The -1 option for ipstat, when used with one of the other options, gives you a long listing 
of the status of the LP print service. To display a long listing of all status information, type 
ipstat -tl and press Return. All available status information is displayed. 

In this example for the same system, additional information is displayed. When files are 
spooled for printing, the status of those print requests is also displayed: 

{:44} ipstat -tl 
scheduler is running 
system default destination: tom 
system for slw2: bertha 
system for slwl: bertha 
device for tom: /dev/term/b 

slw2 accepting requests since Mon May 11 11:01:54 EDT 1992 
slw1 accepting requests since Wed May 27 16:26:38 EDT 1992 
tom accepting requests since Wed Jun 3 14:25:41 EDT 1992 
printer slw2 is idle, enabled since Mon May 11 11:01:55 EDT 1992. available. 
Content types: any 
Printer types: unknown 
Description: 

Users allowed: 

(all) 

Forms allowed: 

(none) 

Banner not required 
Character sets: 

(none) 

Default pitch: 

Default page size: 

printer slwl is idle, enabled since Wed May 27 16:26:38 EDT 1992. available. 
Content types: simple 
Printer types: unknown 
Description: Located in ia lab 
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Users allowed: 

(all) 

Forms allowed: 

(none) 

Banner not required 
Character sets: 

(none) 

Default pitch: 

Default page size: 

printer tom is idle, enabled since Wed Jun 3 14:25:41 EDT 1992. available. 

Form mounted: 

Content types: PS 
Printer types: la100 
Description: hi 
Connection: direct 

Interface: /usr/lib/Ip/model/standard 
After fault: continue 
Users allowed: 

(all) 

Forms allowed: 

(none) 

Banner required 
Character sets: 

usascii 
english 
finnish 
Japanese 
norwegian 
Swedish 
germanic 
french 
canadian_french 
italian 
Spanish 
line 
security 
ebcdic 
apl 
mosaic 

Default pitch: 10 CPI 6 LPI 
Default page size: 132 wide 66 long 
(More information not shown in this example) 

Display of Status for Printers 

You can request printer status information for individual printers by using the - p option to 
ipstat. This option shows whether the printer is active or idle, when it was enabled or 
disabled, and whether it is available to accept print requests. 

To request status for all printers on a system, type Ipstat -p and press Return. In this 
example, two printers are idle, enabled, and available. If one of those printers had jobs in 
the print queue, those jobs would also be displayed: 
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elm% Ipstat -p 

printer pinecone is idle, enabled since Wed Jan 1 18:20:22 PST 1992. available, 
printer acorn is idle, enabled since Mon Mar 2 15:53:44 PST 1992. available. 
elm% 

To request status for an individual printer by name, type Ipstat -p printer‘name and 
press Return. 

Display of Printer Characteristics 

If you want to see all of the characteristics for a printer, use the -p option together with 
the -1 (long) option to ipstat. This command can be especially useful for finding the 
printer type and content type. 

To show characteristics for all printers on.a system, type Ipstat -p -1 and press Return. 

A table shows all the configuration information that is used by the LP print service for 
each printer. 

In this example, all the fields are blank except for the content type and the printer type of 
the printer pinecone: 

elm% Ipstat -p pinecone -1 

printer pinecone is idle, enabled since Wed Jan 1 18:20:22 PST 1992. available. 
Content types: PS 
Printer types: PS 
Description: 

Users allowed: 

(all) 

Forms allowed: 

(none) 

Banner not required 
Character sets: 

(none) 

Default pitch: 

Default page size: 

elni% 

Summary Table of Ipstat Options 

You can request different types of printing status information by using the ipstat 
command. Table 6-10 summarizes the frequently used options for the Ipstat command. 
Use these options individually or combine them in any order on the command line. When 
you combine options, use a space between options and repeat the hyphen (-)• For 
example, to show a long list of status for an individual printer, type ipstat -p 
printer-name -1 and press Return. See the ipstat(l) manual page for a complete list of 
options. 
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Table 6-10 Summary of Frequently Used Options to the tpstst Command 


Option Description 

■ a Accept. Show whether print destinations are accepting requests. 

• c Class. Show classes and their members. 

- d Destination. Show defauit destination. 

- f Forms. Show forms. 

- 0 Output. Show status of output. 

- p [list] I -D] [ -1] Printer/description/long list. Show status of printers. 

- r Request. Request scheduler status. 

-R Show position of job in the queue. 

- S Sets. Show character sets. 

■s Status. Show status summary, 

-u [username] User. Show requests by user. 

- V Show devices. 


Canceling a Print Request 

Use the cancel command to cancel a print request while it is in the queue or while it is 
printing. To cancel a request, you need to know its request ID. The request ID always 
includes the name of the printer, a hyphen, and the number of the print request. When you 
submit the print request, the request ID is displayed. If you do not remember your request 
ID, type Ipstat and press Return. Only the user who submitted the request, or someone 
logged in as root or ip, can cancel a print request. 

Canceling of Print Request by ID Number 

To cancel a print request, type cancel request-ID and press Return. A message is 
displayed telling you that the request is canceled. The next job in the queue begins 
printing. 

In this example, two print requests are canceled: 

el(n% cancel pinecone-3 pinecone-4 
request "pinecone-3'' cancelled 
request "pinecone-4" cancelled 
elm% 


Canceling a File That Currently Is Printing by Printer Name 

You can also cancel just the job that currently is printing (if you submitted it) by typing 
the printer name in place of the request ID. Type cancel printer-naae and press Return. 
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A message is displayed telling you that the request is canceled. The next job in the queue 
begins printing. 

In this example, the currently printing request has been canceled: 

elni% cancel pinecone 

request "pinecone-3“ cancelled 

elni% 

As system administrator, you can log in as root or ip and cancel the currently printing 
request by using the printer name as the argument for the cancel command. 
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Tools for Adding and Administering User Accounts 



T his chapter describes how to set up and administer user accounts and 
groups by using Admintool. You can use Admintool to edit only files in 
the local /etc directory. Functionality that enabled you to edit NIS+ da¬ 
tabases and view NIS maps from Admintool has been moved into the un¬ 
bundled Solstice AdminSuite product. 


NOTE. Solaris 2.x provides the following SVR4 useradd commands: useradd, userdel, 
usermod, groupadd, groupmod, and groupdel. Because these commands are only minimally 
network-aware, they are not described in this chapter. If you want to use these commands to 
administer user accounts on standalone systems, refer to the appropriate manual pages. 


Tools for Adding and Administering User Accounts 



Table 7-1 lists the recommended tools for adding and administering user accounts on 
systems with a graphics monitor running an X Window system such as CDE or 
Open Windows. 


Table 7-1 

Recommended Tools for Administering User Accounts 

Environment 


Recommended Tool 

Avallabllity/Documentation 

Remote and/or local systems In a 
networked, name service (NIS, NIS+) 
environment 

User and Group Manager 
(graphical user interface) from 
the Solstice AdminSuite 

Available as a separate product. Refer to 
the Solstice AdminSuite 2.3 Administration 
Guide. 

Local system 


Admintool (graphical user 
Interface) 

Provided with Solaris 2.6. Instructions 
provided in this chapter. 

Command-line 


Terminal window (CDE 
Environment) or shell tool or 
command tool (OpenWIndows 
Environment) 

Provided with Solaris 2.6. See Table 7-2 
for a list of available commands. Refer to 
the appropriate manual pages. 


You can add and administer user accounts from the command line if you choose not to use 
Admintool or the Solstice AdminSuite. Table 7-2 lists the Solaris commands you can use to 
administer user accounts. 


Table 7-2 Using Solaris Commands to Administer User Accounts 

Task Name Service Commands 

Add a user account NIS + nistbladm 

nisclient 


NIS 


useradd 

make 
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Table 7-2 Using Solaris Commands to Administer User Accounts (continued) 


Task 

Name Service 

Commands 


None 

useradd 

Modify a user account 

NIS+ 

nistbladm 


NIS 

usermod 

make 


None 

usermod 

Delete a user account 

NIS+ 

nistbladm 

nisclient 


NIS 

usendel 

make 


None 

userdel 

Set up user account defaults 

NIS+ 

not available 


NIS 

useradd -D 
make 


None 

useradd -D 

Disable a user account 

NIS+ 

nistbladm 


NIS 

passwd -r nis -1 
make 


None 

passwd -r files -1 

Change a user’s password 

NIS+ 

passwd -r nisplus 


NIS 

passwd -r nis 


None 

passwd -r files 

Sort user accounts 

NIS+ 

niscat 

sort 


NIS 

ypcat 

sort 


None 

awk 

sort 

Rnd a user account 

NIS+ 

nismatch 


NIS 

ypmatch 


None 

grep 

Add a group 

NIS+ 

nistbladm 


NIS 

groupadd 

make 


None 

groupadd 

Modify users in a group 

NIS+ 

nistbladm 
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Table 7-2 Using Solaris Commands to Administer User Accounts (continued) 


Task 

Name Service 

Commands 


NIS 

groupmod 

make 


None 

groupmod 

Delete a group 

NIS+ 

nistbladm 


NIS 

groupdel 

make 


None 

groupdel 



The following sections describe how to use Admintool to add and delete user accounts. 

You may find it useful to create a form from the following checklist to ensure that you 
have all the needed information about a user account before you create it: 


■ Username 

■ UID 

a Primary group 

■ Secondary groups 

■ Comment 

■ Default shell 

■ Password status and aging 

■ Home directory server name 

■ Home directory path name 

■ Mounting method 

■ Permissions on home directory 

■ Mail server 

■ Department name 

■ Department administrator 

■ Manager 

■ Employee name 

■ Employee title 

■ Employee status 
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■ Employee number 

■ Start date 

Adding User Accounts 

Before you add users to the network, the users’ systems must be installed and configured. 
When appropriate, NIS+ or NIS software should be installed and running on the network, 
(Only 4.x systems can be NIS servers. You can have either 4.x or 5.x systems installed as 
NIS clients.) 

Adding users so that they can log in and start working has two steps: setting up the user 
account and providing the user with a working environment. 

When you set up a user account, you 

■ Edit the /etc/passwd file 

■ Define the user’s group(s) 

■ Create a home directory 

■ Define the user’s environment 

■ Create a password 

The next sections provide background information and describe how to do these tasks. 

Editing the /etc/passwd File 

Before you can use Admintool to edit the local /etc/passwd file, you must be a member 
of the sysadmin group (GID 14). 

If you have the appropriate pernussions, you can use Admintool to make changes to the 
/etc/passwd file on a local system. 

You need the following information for each user you plan to add: 

■ Login name 

■ UserID(UID) 

■ Primary group ID (GID) 

■ Identifying information (name, office, extension, home phone) 

■ Home directory 

■ Login shell 
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User ID Number 

A UID is always associated with each user name and is used by systems to identify the 
owners of files and directories and to identify the user at login. If you create user accounts 
for a single individual on more than one system, always use the same user name and UID. 
In that way, the user can easily move and copy files between systems without ownership 
problems. 


A UID must be a whole number less than or equal to 2147483647. The maximum UID 
was increased from 60000 to 2147483647 starting with the Solaris 2.5.1 release. 

UIDs are required for both regular user accounts and special system accounts. Table 7-3 
lists the UIDs that are reserved for user accounts and system accounts. 


Table 7-3 

Reserved UIDs 


UIDs 


Login Accounts 

Description 

0 


root 

Root account 

1 


daemon 

Daemon account 

2 


bin 

Pseudo-user bin account 

3-99 


sys, UUCP logins, 
who, tty, and ttytype 

System accounts 

100-60000 


Regular users 

General-purpose accounts 

60001 


nobody 

Unauthenticated users 

60002 


noaccess 

Compatibility with previous Solaris 2.x and SVR4 
releases 

60003-2147483647 

Regular users 

General-purpose accounts 


CAUTION! Be careful when using UIDs in the 60000 to 2147483647 range. These 
numbers do not have full functionality and are incompatible with many Solaris features. 
See Table 7-4 for more information. 

Even though UIDs 0 through 99 are reserved for use by system accounts, you can add a 
user with one of these UIDs. You should not, however, use these UIDs for regular user 
accounts. Use the numbers 0 through 99 to assign system accounts, uucp logins, and 
pseudo-user logins. 

Large User IDs and Group IDs 

Previous Solaris 2.x releases used 32-bit data types to contain UIDs and GIDs. UIDs and 
GIDs were constrained to a maximum useful value of 60000. The limit on UID and GID 
values has been raised to the maximum value of a signed integer, or 2147483647 with the 
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Solaris 2.5.1 release. Table 1-A lists the interoperability issues with Solaris 2x products 
and commands. 


Table 7-4 

Interoperability Issues for UIDs and GIDs over 60000 

Category 

Product/Command 

Issues/Cautions 

NFS interoperability 

SunOS 4.x NFS software 

SunOS 4.x NFS server and client code truncates large 
UIDs and GiDs to 16 bits. This truncation can create 
security problems if SunOS 4.x systems are used In an 
environment where large UIDs and GIDs are being 
used. SunOS 4.x systems require a patch. 

Name Service 
Interoperability 

NIS name service 

File-based name service 

Users with UIDs above 60000 can log in and use the 
su command on systems running earlier versions of 
the Solaris 2.x operating environment, however, their 
UIDs and GIDs are set to 60001 (nobody). 


NIS-+ name service 

Users with UIDs above 60000 are denied access on 
systems running older Solaris 2,x versions and the 

N1S+ name service. 

Printed UIDs/GIDs 

OpenWindows File Manager 

Large UIDs and GIDs are not displayed correctly if the ' 
OpenWindows File Manager is used with the extended 
file listing display option. 

Table 7- 

-5 summarizes the limitations of using large UIDs and GEDs. 


Table 7-5 Limitations of Using UIDs and GIDs over 60000 


UID/GID Number 

60003 or greater 


65536 or greater 


100000 or greater 


Limitation 

Users logging in to systems running previous Solaris releases and the NIS or files 
name service are assigned a UID and GID of nobody. 

SunOS 4.x systems running the NFS version 2 software truncate UIDs in this 
category to 16 bits, creating possible security problems. 

Using the cpio command with the default archive format to copy files displays an 
error message for each file and the UID and GID are set to nobody in the archive. 

SPARC systems: SunOS 4.x-compatible applications display EOVERFLOW messages 
from some system calls and the UID and GID are set to nobody. 

x86 systems: SVR3-compatlble applications on an x86 system is likely to display 
EOVERFLOW messages from system calls. 

x86 systems: If users create a file or directory on a mounted System V file system, 
the Systenri V file system returns an EOVERFLOW error. 

The ps -1 command displays a maximum five-digit UID so the printed column is not 
aligned when it includes a UID or GID greater than 99999. 
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Table 7-5 Limitations of Using UIDs and GIDs over 60000 (continued) 

UID/GID Number Limitation 


2622144 or greater Using the cpio command with -H ode format or the pax -x cpio command to 

copy files returns an error message for each file and the UIDs and GIDs are set to 
nobody in the archive. 

10000000 or greater Using the ar command sets UIDs and GIDs to nobody in the archive. 

2097152 or greater UIDs and GIDs are set to nobody when using the tar command, the cpio -H ustar 

command, or the pax -x tar command. 


Creating a Home Directory 

The home directory is that portion of a file system that is allocated to an individual user 
for storing private files. The amount of space you allocate for a home directory may vary, 
depending on the kinds of files the users create and the type of work they do. You should 
probably allocate at least 15 Mbyte of disk space for each user’s home directory. 

A user’s home directory can be either on the local system or on a remote file server. In 
either case, by convention the home directory is created as /export / home /login-name. 
Note that this convention is new with Solaris 2jc. The server name is no longer included as 
part of the user’s home directory path. On a large server that supports a number of users’ 
home directories, there may be a number of directories under /export —such as homel, 
homea, homes, and so on—with directories for different users under them. Regardless of 
where their home directory is located, users access their home directory through a mount 
point named / home / login - name. 



Always refer to the home directory as $H0ME, not as /export/home/username. In addition, 
use relative paths to create any symbolic links in a user’s home directory (for example, 
../../.. / x/y/x), so that the links are valid no matter where the home directory is 
mounted. 


This section describes the default procedure for Solaris 2.x, which assumes that the user’s 
system is on a network and that AutoFS is used to make the home directory accessible. 
Whether the home directory originates on a server or on the local system, you need to 
make it accessible to other systems by using the share command to export the file system 
so that the user can access the home directory from other systems on the network. 

In addition, you need to define how the home directory is mounted, by either: 


■ Adding an entry to the NiS+ Auto_home database, nis auto, home map, or local 
/etc/auto_home files so that the home directory is automatically mounted. This is the 
preferred method. 

■ Adding an entry in the / etc/vf stab file on the user’s system to NFS-mount the home 
directory. 
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To support automatic mounting of home directories, the SunOS 5^ system software 
includes this entry in the /etc/auto_niaster file: 

/home /etc/auto_home 

This entry tells AutoFS to mount the directories specified in the auto_home database onto 
the /home mount point on the local system. The entries in auto_home use this format: 

login-name system-name:/export/home/login-name 

When a user logs in with login-name, AutoFS mounts the specified directory 
(/export/home/Jo 5 in-na/!?e) from f the specified system (system-name) onto the /home 
mount point on the system to which the user is logged in. 

This method works even when the home directory is stored on the same system to which 
the user has logged in. But more importantly, the user can log in to any other system and 
have his or her home directory mounted on /home on that system. 

NOTE. When AutoFS is used to mount home directories, you are not permitted to create 
any directories under the /home mount point on the user’s system. The system recognizes 
the special status of /home when AutoFS is active. 

To create a home directory, you must already have created the user’s account. You need 
this information: 

■ User’s login name and UID. 

■ The name of the system on which to create the home directory. If the home directory is 
accessed over the network, the home directory system should be on the same network 
segment as the user’s local system. Use the df command to check the servers to make 
sure there is enough space for a new home directory. 

■ The name of the directory where you will create the user’s account. By convention, the 
home directory is named /export/home. However, on a large file server you may have 
multiple directories— /export/hornet, /export/home2, and so on. Under each directory, 
different subdirectories are created for different users (for example, 

/export/home/login-namea, /export/home/login-nameb ... 

/ export /hornet /login-namey .. . / export/homeZ/login-namez, and so forth). 

All these steps apply regardless of whether the home directory is created on the local 
system or on a remote file server: 

1. Become superuser on the system where you want to create the home directory. 

2. Type cd /export/Afl®»'</jf/’and press Return. The/70/i?e-dir is the name of the 
directory where you want to create the user’s home directory. For example, to 
change to the directory /export/homel, type: 
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# cd /export/homel 

3. Type mkdir login-name and press Return, login-name is the login name of the user. 
You have created a directory that matches the login name of the user. For example, 
to create a directory for a user withf a login name of ignatz, type: 

# tnkdir ignatz 

4. Type chown login-name login-name and press Return. The user now owns the home 
directory. For example, for user ignatz, type: 

# chown Ignatz Ignatz 

5. Type chgrp primary-QlD login-name and press Return. The user is assigned to the 
primary group you specified in the Passwd database for the user account, for 
example, the staff group: 

# chgrp staff ignatz 

6. Type chmod 755 /export/AaB»-tf.//*/ioflr//7-/7flffi« and press Return. The user’s home 
directory permissions are set to rwx for owner, r-x for group, and r-x for other: 

# chmod 755 /export/homel/ignatz 

# 

The following steps describe how to share a home directory from a 5.x server. The 
procedure for sharing home directories from a 4.x server uses the export command. 

1. Type share and press Return to find out whether the home directory has already been 
shared. If the home directory is listed, you will see information that looks like this: 

oak% su 
Password: 

# share 

/export/home rw 

# 

If the home directory is not listed, perform the following steps to set it up so that it 
can be shared by other systems. You perform these steps once for each 
I export I home-dir directory. By convention, these are named /export/home, 
/export/homel, / export/home2, and so on. 

2. Edit the file /etc /df s /df stab and add this line: 
share -F nfs /export/<home-dir> 

3. Type shareall -F nfs and press Return. All the share commands in the 
/etc/df s/df stab file are executed so that you do not need to reboot the system. If 
you reboot the system, the share command is automatically run. 

4. Type ps -ef ! grep mountd and press Return. If the daemon mountd is running, the 
procedure is complete. This example shows that a mountd is not running. If mountd is 
not running, follow the next step. 
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# ps -ef I grep mountd 

root 221 218 16 18:07:25 pts/1 0:00 grep mountd 

5. Type /etc/init.d/nfs. server start and press Return. The daemons required for 
sharing file directories are started. 

NOTE. If your network is not running NISI or NIS+, you need to add the home directory 
server’s Internet Protocol (IP) address and system name to the /etc/hosts file on the 
user’s system. You can use the Admintool: Hosts window to edit the local /etc/hosts file. 

If you use disk quotas, set up a disk quota for the user. 

After you have created the user’s home directory, you must make it available. You make 
the home directory available either by adding it to the Auto_home database (the preferred 
method) for use by AutoFS, or by adding an entry to the / etc /vf stab file on the user’s 
system for NFS mounting. 

NFS-Mounting the Home Directory 

If the directory (disk space) for a user’s home directory is located on another system and 
AutoFS is not being used to make that space available, follow these steps to NFS-mount 
the home directory: 

1. Become superuser on the user’s system. 

2. Edit the /etc/vf stab file and create an entry for the user’s home directory. For 
example, to create an entry for user ignatz with a home directory on server oak, you 
would add this line to the file: 

oak;/export/homel/ignatz - /home/ignatz nfs - yes rw,intr 

3. To create the mount point on the user’s system, type mkdir /home/ login-name and 
press Return. 

NOTE. The home directory does not have the same name on the user's system as 
it does on the server. For example, I export / home / ignatz on the server is mounted as 
/home/ignatz on the user’s system. 

4. Type chown login-name fhmellogin -name and press Return. The user now owns the 
home directory. 

5. Type chgrp primary -GID / tram I login-name and press Return. The user’s primary 
group has permission to access the user’s home directory. 

6. Type mountaii and press Return. All entries in the current vfstab file (whose automnt 
fields are set to Yes) are mounted. 

7. To verify that all entries are mounted, type mount and press Return. The file systems 
that are mounted are displayed. 
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Defining the User’s Environment 

To completely set up the user account, you must also: 

■ Define default initialization files 

■ Set up a mail account 

■ Set up a printer 

Defining initialization RIes 

When a user logs in, the login program sets a number of variables, such as home, logname, 
and TZ. Then a file called the system profile (initialization file) is run to set systemwide 
defaults such as path, message of the day, and umask. Finally, the user profile initialization 
file (or files) that sets variables specific to the user is run. For example, the user profile 
can modify the path to include applications run by only that user. Each shell has its own 
initialization file (or files), as shown in Table 7~6. 


Table 

Shell 

C 


Bourne 

Korn 


7-6 Shell User Initialization RIes 


Initialization File 

$H0ME/.login 
$HOME/.cshrc 
$HOME/.profile 
$HOME/.profile 
$HOME/ksh-env 


Purpose 

Defines user’s environment at login 

Defines user’s environment for all C shells invoked after login shell 
Defines user’s environment at login 
Defines user’s environment at login 

Defines user's environment at login in the file specified by the ksh-env 
environment variable 


The SunOS 5 jc system software provides default user initialization files for each shell in 
the /etc/skel directoty, as shown in Table 7-7. 


Table 7-7 

Shell 

C 

c 

Bourne or Korn 


Default Home Directory Initialization RIes 

File Name 

/etc/skel/local.login 
/etc/skel/local.cshrc 
/etc/skel/local.profile 


Here is the default /etc/skel/local.login file: 
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# @(#)local.login 1.3 93/09/15 SMI 

stty -istrip 

# setenv TERM 'tset -Q 

# 

# if possible, start the windows system, tGive user a chance to bail out 

# 

if ( 'tty' == "/dev/console" ) then 

if ( $TERM == "sun" II $TERM == "AT386" } then 

if ( ${?OPENWINHOME} == 0 ) then 

setenv OPENWINHOME /usr/openwin 

endif 
echo "" 

echo -n "Starting OpenWindows in 5 seconds (type Control-C to 

interrupt)" 

sleep 5 
echo "" 

SOPENWINHOME/bin/openwin 

clear # get rid of annoying cursor rectangle 

logout # logout after leaving windows system 

endif 

endif 

Here is the default /etc/skel/local.cshrc file; 

# @(#)cshrc 1,11 89/11/29 SMI 
umask 022 

set path=(/bin /usr/bin /usr/ucb /etc .). 
if ( $?prompt ) then 

set history=32 

endif 

Here is the default /etc/skel/local.profile file; 

# @(#)local.profile 1.4 93/09/15 SMI 
stty istrip 

PATH=/usr/bin:/usr/ucb:/etc:. 
export PATH 

# 

# If possible, start the windows system 

# 

if [ 'tty' = “/dev/console" ] ; then 

if [ "STERM" = "sun" -o "STERM" = "AT386" ] ; then 
if [ $ {OPENWINHOME:= "" ] ; then 
0PENWINH0ME=/usr/openwin 
export OPENWINHOME 

fi 

echo “" 

echo "Starting OpenWindows in 5 seconds (type Control-C to 

interrupt)" 

sleep 5 
echo "" 

$OPENWINHOME/bin/openwin 
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clear # get rid of annoying cursor rectangle 

exit # logout after leaving windows system 

fi 
fi 

As you can see, these files define a minimal t environment. To minimize the need to edit 
the customization files for each user, you can customize the files in /etc/skel to set as 
many systemwide default variables as you can. You will need to edit individual users’ 
customization files to set the user’s path. 

To set up initialization files, you must already have created the user’s home directory and 
know which shell (C, Bourne, or Korn) is set in the user’s account entry in the Passwd 
database. Follow these steps to set up the user’s initialization files; 

1. Become superuser on the system with the user’s home directory. 

2. Type cd I home-dir/login-naae and press Return. You are in the user’s home 
directory. For example to change to user ignatz ‘ s directory which is in 

/ export/homel, type: # cd /export/homel/ignatz. 

3. Type cp /etc/skel/local. * . and press Return. You have copied all of the default 
user initialization files to the user’s home directory. 

4. Type chmod 744 local, * and press Return. Permissions are set for the initialization 
files. 

5. Type chown login-name * and press Return. The user now owns the initialization 
files; 

# chown ignatz * 

# 

6. Type chgrp primary-GID local. * and press Return. The files are assigned to the 
primary group (for example, sysadmin) you specified in the Passwd database for the 
user account: 

# chgrp 10 local.* 

7. Rename the shell initialization files. If the user’s shell is the C shell, type mv 
local.login .login; mv local.cshrc .cshrc and press Return. If the user’s shell is 
the Korn or Bourne shell, type mv local, profile . profile and press Return. 

8. Type rm local. * and press Return. You have removed the unused shell initialization 
files. 

9. Mount the user’s home directory. 

10. On the user’s system, log in as the user. 

11. Assign the t user an interim password. See “Creating a Password” later in the chapter 
for information on how to create passwords. 
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12. Check to make sure the user’s environment is set up correctly. 

13. Edit the user’s initialization file (or files) and make changes as needed. 

To edit the user’s initialization file (or files): 

1. Set the user’s default path to include the home directory and directories or mount 
points for the user’s windowing environment and applications. 

2. To change the path setting, add or modify the line for path as follows. For the C 
shell, type set path =(. /dlrnamel ltUrnam2 /dirnaaeS ...). For example, enter a 
line like this in the user’s $home/ . cshrc file: 

set path=(. /usr/openwin/bin /usr/dt/bin /usr/bin /$home/bin /lib /usr/lib) 
For the Bourne or Kom shell, type PATH= .; Idirnamel:/dlrnaae2: / dirnameS . - .; ex - 
port PATH. For example, enter a line such as the following in the user’s $home/ . pro - 
file file: 

PATH=.:/usr/openwin/bin:/usr/dt/bin /usr/bin:/$H0ME/bin:/lib:/usr/lib; 
export PATH 

3. To check that the environment variables are set correctly, type env and press Return. 
Note that the variables are shown using Bourne or Kom shell syntax, even if the 
user’s shell is the C shell. Type man =s5 environ and press Return for more 
information: 

$ env 

H0ME=/home/ignatz 
HZ=100 

LOGNAME=ignatz 
MAIL=/var/mail/ignatz 

MANSECTS=\1:1ni:1c:1f:1s:1b:2:\3:3c;3i:3n:3m:3k:3g:3e:3x11;3xt:3w:3b:9:4:5;7:8 
PATH=: /usr/openwin/bin: /sbin: /usr/sbin; / usr/bin: / etc: /$H0IVIE/bin: /lib: /usr/lib 
SHELL=/bin/sh 
TERM=sun 
TZ=EST5EDT 
$ 

4. Add or change the settings of environment variables. For the C shell, type setenv 
VARIABLE value (or set variable’^value for the path and term variables). For 
example, this line sets the history to the last 100 commands: 

setenv HISTORY 100 

For the Bourne or Kom shell, type YARlABLE-value\ export VARIABLE. For example, 
this line sets the user’s default mail directory: 

MAIL=/var/mail/ignatz;export MAIL 

5. Check the umask setting. If you need to change it, type umask nun and press Return. 

You can either includet or omit leading zeros. For example, to set file permissions to 
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644, type umask 022. Table 7-8 shows the file permissions that are created for each 
of the octal values of umask. 


Table 7-8 Permissions for umask Values 


Octal Value File Permissions 


0 rwx 

1 nw - 


2 r-x 

3 r- - 


4 - wx 

5 -w- 


6 - -X 

7 - - - (none) 


The LANG variable and lc environment variables determine the locale-specific conversions 
and conventions the shell uses. These conversions and conventions include time zones, 
collation orders, and formats of dates, time, currency, and numbers. If necessary, set these 
variables in the user’s initialization file, lang sets all possible conversions and conventions 
for a given locale. If you have special needs, you can set various aspects of localization 
separately using the lc variables lc_collate, lc_ctype, lc_iviessages, and lc_numeric. 
Table 7-9 shows the values for several locales. 

If the system needs to support multibyte characters (for example, Japanese), add this 
command to the system initialization file (/etc/profile or /etc/.login): stty css 
def eucw. When the initialization files are complete, log out of the user’s account. 


Table 7-9 

Values for LANG and LC Variables 

Value 

Locale 

de: 

German 

fr: 

French 

iso_8895_1 

English and European 

it 

Italian 

Japanese 

Japanese 

Korean 

Korean 

sv 

Swedish 
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Table 7-9 Values for LANG and LC Variables (continued) 

tchinese Taiwanese 


Setting Up a User’s Mail Account 

Each user has a mailbox either on a local system or on a mail server and a mail alias in 
the / etc/mail/aliases file that points to the location of the mailbox. To set up a mail 
client with a mailbox on a mail server: 

1. Become superuser on the mail client’s system. 

2. Create a /var/mail mount point on the mail client’s system, 

3. Edit the / etc/vf stab file and add an entry for the /var/mail directory on the mail 
server, mounting it on the local /var/mail directory. The client’s mailbox will 
automatically be mounted any time the system is rebooted. 

4. Type mount -a to mount the mailbox. The client’s mailbox is mounted. 

5. Use Admintool to edit the /etc/hosts file and add an entry for the mail server. 

NOTE. The sendmailprogram automatically creates mailboxes in the / var/mail direc¬ 
tory the first time a message is delivered. You do not need to create individual mailboxes 
for your mail clients. 

If you are using NIS+, follow these steps to set up mail aliases for the user: 

1. Compile a list of each of your mail t clients, the locations of their mailboxes, and the 
names of the mail server systems. 

2. Become superuser on any system. 

3. For each alias, type aliasadm -a aJJas expanded-alias [options comments] and 

press Return. The alias is added to the NIS+ aliases table. For example, adding an 
alias for user iggy. ignatz would look like this: 

# aliasadm -a iggy iggy.ignatzioak "Iggy Ignatz" 

4. Type aliasadm -m alias and press Return. The entry you created is displayed. 

5. Check the entry to be sure it is correct. 

Setting Up a User’s Printer 

After adding users to a system, make sure they have access to a printer. See Chapter 6, 
“Administering Printing,” for information on how to set up printing services. 
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Creating a Password 

Passwords are an important of system security. Each user account should be assigned 
a password of 6 to 10 characters using a combination of letters and numbers. See the 
passwd(l), yppasswd(l), or nispasswd(l) manual pages for information about changing 
passwords and password attributes. 

In the SunOS 4.x system, encrypted passwords are stored in the /etc /passwd file along 
with the rest of the information about the user. In SunOS 5.^:, the encrypted password and 
associated password aging information are stored in the Shadow field of the NIS+ Passwd 
database (or in the local /etc/shadow file). Permissions on the Shadow field are restricted. 

Permissions for the /etc/shadow file are -r. . Only root can read the /etc/shadow 

file, and only the passwd, yppasswd, and nispasswd commands can write to the file. 

Here is an example of an /etc/shadow file: 

root:XzVuaelvazZsw:8223:::::: 
daemon:NP:6445:::::: 
bin:NP:6445:::;:: 
sys:NP;6445::;::: 
adm:NP:6445:::::: 
lp:NP:6445:::::: 
smtp:NP;6445:::::: 

UUCP:NP:6445:::::: 
nuucp:NP:6445:::::: 
listen:*LK*::::::: 
nobody:NP:6445:: 
noaccess:NP:6445:::::: 
nobody4:NP:6445:::::: 
winsor:gzqgnnlKcfy7A:8223:::::: 

To create or modify passwords, use one of these commands: 

■ /usr/bin/passwd (for no naming service) 

■ /usr/bin/nispasswd (for the NIS+ naming service) 

■ /usr/bin/yppasswd (for the NIS naming service) 

Users can create or change their own passwords at any time. You must be root to create the 
initial password for any other user. In addition, to create an NIS+ password, you must 
have the appropriate NIS+ privileges and you must have established the necessary 
networkwide credentials, (See the nispasswd(l) manual page.) 

Follow these steps to create an NIS+ password: 

1. Become superuser on the NIS+ server. 

2. Type nispasswd login-name and press Return. The message New nis+ password: is 
displayed. 

3. Type the new password and press Return. The prompt Retype new NIS+ password: is 
displayed. 
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4. Retype the password and press Return. The password is assigned and added to the 
NIS+ database. 

In this example, a new password is assigned for the user ignatz: 

oak% su 
Password: 

# nispasswd ignatz 

New NIS+ password: 

Retype new NIS+ password: 

# 

Follow these steps to change an NIS+ password: 

1. Become superuser on the NIS+ server. 

2. Type nispasswd ./£Vi>7-/raffle and press Return. The prompt Old password: is 
displayed. 

3. Type the old password and press Return. The prompt New password: is displayed. 

4. Type the new password and press Return. The prompt Re - enter new password: is 
displayed. 

5. Retype the password and press Return. The password is assigned and added to the 
/etc/shadow file. 

In this example, the password for user ignatz is changed: 

oak% su 
Password: 

# nispasswd ignatz 
Old password: 

Hew password: 

Re-enter new password: 

# 

N OTE . You can also use nispasswd to define, change, and view password attributes, 
such as password aging. See the nispasswdf 1) manual page for more information. 

Follow these steps to create an NIS password: 

1. Become superuser on any system in the NIS domain. 

2. Type yppasswd login-name and press Return. The message Changing NIS password 
for login-name and the prompt New password: are displayed. 

3. Type the new password and press Return. The prompt Retype new password: is 
displayed. 

4. Retype the password and press Return. The password is assigned and added to the 
NIS master file. 

In this example, the NIS password is changed for user yaya: 
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oak% su 
Password: 

# yppasswd yaya 

Changing NIS password for yaya 
New password: 

Retype new password: 

NIS entry changed on eucalyptus 

# 

Changing an NIS password is similar to changing an NIS+ password. When prompted to 
do so, type the old password, and then the new password two times. 

Follow these steps to create a local password: 

1. Become superuser on the local system. 

2. Type passwd login-name and press Return. The prompt New password; is displayed. 

3. Type the new password and press Return. The prompt Re-enter new password; is 
displayed. 

4. Retype the password and press Return. The password is assigned and added to the 
/etc /shadow file; 

oak% su 

# passwd smallberrles 

New password: 

Re-enter new password: 

# 

NOTE. You can also use passwd to define, change, and view password attributes, such 
as password aging. See the passwdfij manual page for more information. 

Changing a local password is similar to changing an NIS+ password. When prompted to 
do so, type the old password, and then the new password two times. 


The Admintool: Users Window 

You can use the Admintool: Users window to add, modify, and delete user accounts on a 
local system. 

Always run Admintool using your own UID, not as root. You must be a member of the 
sysadmin group (GID 14). If the network is running NIS+, you also need create and delete 
permissions on the NIS-f databases. 


Adding a User Account 

Follow these steps to add a user account to a local system with the Admintool: Users 
window: 
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1. In a terminal window, type admintool& and press Return. The Admintool: 
Userswindow is displayed, as shown in Figure 7-1. 


Figure 7-1 

The Admintool: Users 
window 



2. From the Browse menu, choose Users, as shown in Figure 7-2 (if necessary). 


Figure 7-2 

The Users Browse menu 
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3. From the Edit menu, choose Add, as shown in Figure 7-3. 

The Admintool; Add User window is displayed, as shown in Figure 1-^. 


Figure 7-3 

The Users.'Edit menu. 



Figure 7-4 

The Admintool: Add User 
window. 
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4, Type the user’s login name in the User Name text field. Choose a login name unique 
to your organization with two to eight lowercase characters and digits (excluding 
colons). 
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5. Type the UID number in the User ID text field. Choose a number between 100 and 
60000 or between 60003 and 2147483647 that is unique to your organization. By 
default the Admintool: Add User window assigns a default UID number, 
sequentially starting with 1001. 

6. Type the user’s group name or group number in the Primary Group field. The default 
primary group number is 10.. 

7. If the user is assigned to any secondary groups, type the names or numbers of the 
additional groups in the Secondary Groups text field. 

8. Type identifying information about the user in the Comment text field. 

9. Choose a default login shell for the user from the Login Shell menu. 

10. Choose a password status from the Password menu. 

11. If you want additional password aging information, set it in the appropriate text 
fields. 

12. If you want to automatically create the user’s home directory, click select on the 
Create Home Dir checkbox. 

13. Type the path of the home directory to be entered in the Passwd database in the Path 
text field. If you checked the Create Home Dir box, the home directory is created. 

14. When you have filled in all the information, click on the OK button. The information 
is added to the /etc/passwd, /etc/shadow, and /etc/group files. If specified, the 
user’s home directory is created with the proper ownership. 

15. Set up the user initialization files manually, as described in “Defining the User’s 
Environment.” 


Administering User Accounts 

Administering user accounts includes modifying, removing, and disabling the accounts. 


Modifying User Accounts 

When information about the user changes, use the Admintool: Users window to edit the 
information in the /etc/passwd file. Unless you define a user (login) name or UID that 
conflicts with existing ones, you probably will not need to modify a user account’s login 
name or UID. 

In a network environment, you may need to change the Auto_home database for the user’s 
home directory when users move from one system to another, and from one server to 
another. 

If you need to modify user passwords, use the passwd (no naming service), yppasswd 
(NIS), and nispasswd (NIS+) commands. 
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To modify a user account by using Admintool, you must be a member of the sysadmin 
group (GID 14). If you want to change a user’s home directory, create the new directory 
(itikdir) before making changes by using the Admintool: Users window. 

Follow these steps to modify a user account: 


1. In the Admintool; Users window, click on thei user account you want to modify, as 
shown in Figure 7-5. 


Figure 7-5 

Highlighting a user account. 
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2. From the Edit menu, choose Modify, as shown in Figure 7-6. 

The Admintool: Modify User window is displayed, as shown in Figure 7-7. 


Figure 7-6 

Choosing Modify from the 
Edit menu. 
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Figure 7-7 

The Admintool: Modify User 
window 
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3. Make the modifications to the iuser account. 

4. When the changes are complete, click on the OK button. The changes are made to 
the user account. 

Deleting User Accounts 

Here is a checklist for deleting a user account: 

■ Delete the user’s entry from the NIS+ Passwd database, NIS map, or /etc/passwd files. 

■ Remove the user’s name from entries in the NIS+ Group database, NIS map, or 
/etc/group files, 

■ Remove the user from any printer access or deny lists. 

■ Decide whether you want to delete or archive all of the user’s files. 

■ Delete the user’s mail file. 

■ Remove the user from the Auto home database. 


Deleting a User Account Using Admintool 

To delete a user account using Admintool, you must be a member of the sysadmin group 
(GID 14). 
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Follow these steps to delete a user account: 

1 . From the Admintool: Users window, click on the user account you want to delete. 
The user account is highlighted. 

2. From the Edit menu, choose Delete. An alert window is displayed, as shown in 
Figure 7-8, asking you to confirm or cancel the action. 

Figure 7-8 

Alert window 


3. If you want to delete the home directory along with the user account, click on the 
Delete Home Directory check box. 

4. Click on the Delete button to delete the user account. The user account is deleted and 
removed from the list in the Admintool: Users list. If you checked the Delete Home 
Directory check box, the home directory is also deleted. If you want to retain the 
account, click on the Cancel button to dismiss the window. 
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Disabling User Accounts 

Occasionally, you may need to temporarily or permanently disable a login account. You 
should have good reason for taking such action. For example, the user may be on leave of 
absence or you may have strong evidence that the account is being misused or security is 
being violated. 

The easiest way to disable a login account is to lock the password for an account. To lock 
the password on a local system, modify the user account and choose Account is Locked 
from the Password menu in the Admintool: Modify User window, as shown in Figure 7-9. 



234 


Administering User Accounts and Groups 


Figure 7-9 

The Admintool:Modify User 
Password menu. 



On a local system, you can control access to a user’s account by requiring password aging, 
by setting an expiration date for the login account, or by requiring that a user access the 
account at regular intervals. Another way that you can disable a login is to temporarily 
change the password. 


Setting Up and Administering Groups 

The Group database (map, or local /etc/group file) stores information about user 
groups, traditionally called UNIX groups. A user group is a collection of users who can 
share files and other system resources. For example, a set of users who are working on the 
same project could be formed into a user group. 

Each group has a GID, which identifies it internally to the system. A group should have a 
name and a list of user names. User groups can be defined in two ways: 

■ Implicitly, by the GID for the user’s primary group, which is defined in the user 
account. Whenever a new GID appears in the Group field of the Passwd database, a new 
group is defined. 

■ Explicitly, by name, GID, and user list, as entered into the Group database. 

NOTE. It’s best to explicitly define all groups so every group has a name. 
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All users belong to at least one group—their primary group—^which is indicated by the 
Group field of their user account. Although it is not required by the operating system, you 
should add the user to the member list of the group you’ve designated as his or her 
primary group. Optionally, users can belong to up to 16 secondary groups. To belong to a 
secondary group, the user must be added to the group’s member list. 

The groups command shows the groups to which a user belongs. For any user, only one 
group can be considered the primary group at a time. However, users can temporarily 
change the primary group (with the newgrp command) to any other group they belong to. 

Some applications, such as the file system, look at the user’s primary group only. For 
example, ownership of files created, and recorded accounting data reflect only the primary 
group. Other applications may take into account a user’s membership across groups. For 
example, a user has to be a member of the sysadmin group to use Admintool to make 
changes to a database, but it doesn’t matter if sysadmin is the current primary group. 

User groups probably are best known as the groups referred to by the read-write-execute 
permissions for the user, group, and other on files and directories. These permissions are a 
cornerstone of security. You cannot access others’ files (if they do not allow world access) 
unless your primary or a secondary group has permission to access the files. For example, 
a group called techwrite could be created for technical writers, and a central directory of 
document files could be set up with write permission for the techwrite group. That way, 
only writers would be able to change the files. 

User groups can be local to a workstation or used across a network. Across the network, 
user groups allow a set of users on the network to access a set of files on a workstation or 
file server without making those files available to everyone. 

NOTE. NIS+ supports another, unrelated, kind of group, called NIS+ group, which as¬ 
signs access rights to NIS+ objects. These groups have nothing to do with using NIS+ to 
maintain a database of user groups. 

Setting Up Fields in the Group Database 

The Group database (map, or local /etc/group file) has these fields: 

■ Group Name 

■ Group ID 

■ User (Member) List 

There is an additional field that rarely is used: the Group Password. The Group Password 
field is a relic of earlier versions of UNIX. It is usually left empty or filled with an 
asterisk. If a group has a password, the newgrp command prompts users to enter it. 
However, there is no utility to set the password. 
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Setting Up a Group Name Field 

The Group Name field contains the name assigned to the group. For example, members of 
the chemistry department in a university may be called chem. Group names can have a 
maximum of nine characters. 

Setting Up a Group ID Field 

The Group ID field contains the group’s numerical ID. It must be unique from all other 
group IDs on a system and should be unique across the entire organization. Each GID 
must be a Avhole number between 0 and 60002, but customarily you use numbers from 
100 to 60000. (Numbers 60001 and 60002 are assigned to nobody and noaccess, 
respectively, and numbers under 100 are reserved for system default group accounts.) 
When you use Admintool to add user accounts, you must specify the user’s primary 
group; otherwise, the default primary group is root with a GID of 0. For security reasons, 
you do not want users to have a group of root. 

Starting with the Solaris 2.5.1 release, you can also assign GID numbers between 6003 
and 2147483647. If you use GID numbers in this range, refer to Table 7-4 and Table 7-5 
for information about interoperability issues and limitations on large GID numbers. 

Setting Up a User (Member) List Field 

The User List field contains a list of the users in the group. User names are separated by 
commas. These names must be the official login names defined in the Passwd database. As 
already noted, each user can belong to a maximum of 17 groups. 

Identifying Default UNIX User Groups 

By default, all SunOS 5.x workstations and servers have these groups: 

root::0:root 
other::1: 

bin::2:root,bin,daemon 
sys:;3:root,bin,sys,adm 
adm::4:root,adm,daemon 
uucp::5:root,uucp 
mail::6:root 
tty::7:root,tty,adm 
Ip::8:root,Ip,adm 
nuucp::9:root,nuucp 
staff::10: 

daemon::12:root,daemon 
sysadmin;:14: 
nobody::60001: 
noaccess::60002: 
nogroup::65534 

NOTE. The sysadmin group with a GID of 14 is now part of the default set of groups. 
This group specifies the users who have access to all functions of Admintool. 
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Creating New Groups 

As a system administrator, you will frequently create new group accounts. You must 
create a group and assign it a GID before you can assign users to it. 

Use Admintool to create and maintain local groups. You must be a member of the 
sysadmin group (GID 14) before you can use Admintool to create or edit group accounts. 

You need this information to create a new group: 

■ Login names of users who will belong to the group 

■ UIDs of users who will belong to the group 

■ Group name 

■ GID 

Follow these steps to add groups to a local / etc/group file; 

1. Start Admintool (if necessary) by typing admintooia and pressing Return. 

2. From the Browse menu, choose Groups. The Admintool: Groups window is 
displayed, as shown in Figure 7-10. 



Figure 7-10 

The Admintool: Groups 
window. 
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3. From the Edit menu, choose Add. The Admintool: Add Group window is displayed, 
as shown in Figure 7-11. 


Rgure 7-11 

The Admintool: Add Group 
wiruiow. 



4. Type the name of the group, the new group number, and the members of the group. 
Members of a group are defined as a comma-separated list of login names. Spaces 
are not allowed. If you need help in determining the format for any of the fields, 
click on the Help button. A help window is displayed, as shown in Figure 7-12. 


Figure 7-12 

The Admintool: Help 
window. 
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5. When the information is complete, click on the OK button. The group is created and 
added to the local /etc /group file. 
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Modifying or Deleting Groups 

Membership in group accounts can change frequently as new employees are hired 
and other employees change job responsibilities. Consequently, you have to modify 
existing group accounts to add or remove users. If you choose to have a user belong to 
secondary groups, you have to modify those groups to add the user to the user lists. 

When adding groups, you may make a mistake. The ability to delete groups helps you 
correct such mistakes. 

NOTE. When projects finish, groups set up for them may no longer be needed, and these 
groups can be deleted. You should be careful to avoid conflicts if you reuse the GIDsfrom 
deleted groups. 

Modifying a Group 

Follow these steps to modify a group entry: 

1. Start Admintool (if necessary). 

2. From the Browse menu, choose Groups. The Admintool: Groups window is 
displayed. 

3. Click on the group you want to modify. The item is highlighted, 

4. From the Edit menu, choose Modify. The Admintool: Modify Group window is 
displayed. 

5. Make the changes to the group. 

6- When the changes are complete, click on the OK, button. The changes are made to 
the local /etc/group file. 

Deleting a Group 

If a group account is no longer needed, you can delete it. Follow ±ese steps to delete a 
group: 

1. Click on the group you want to delete. The item is highlighted. 

2. From the Edit menu, choose Delete. An alert window is displayed asking if you want 
to delete the group. 

3. Click on the Delete button. The group is deleted from the /etc/group file and is 
removed from the list in the Admintool: Groups window. If you want to retain the 
group, click on the Cancel button. 


Solaris User Registration 

Solaris User Registration is a tool for gathering information about new Solaris releases, 
upgrade offers, and promotions. This tool automatically starts when a user first logs in to 



240 


Administerinq User Accounts and Groups 


the desktop. The Solaris User Registration tool enables a user to register now, later, or 
never. The registration process provides Sun with the user’s Solaris version, survey type, 
platform, hardware, and locale. 

NOTE. Solaris User Registration is not started when a user is logged in as root or 
superuser. 

If the user chooses to register, a copy of the completed form is stored in 

$H0ME/. solregis/uprops. If the user chooses to never register, he can always start User 

Registration in one of the following ways: 

■ By typing solregis at any command line prompt. 

■ By clicking on the Registration icon in the Application Manager’s desktop tools folder 
in the CDE environment. 

For more information, refer to the solregis(l) manual page. 

Error Conditions 

Table 7-10 suggests ways to resolve user problems with registration. 


Table 7-10 Registration Errors 


Probiem Solution 

Registration form failed to initialize: Web Check for missing registration files, 
page window is displayed, requesting that 
user see the system administrator to resolve 
the problem. 


Form could not be e-mailed: Dialog box is Check to whether if e-mail is configured correctly. Also 
displayed requesting that user see the ensure that CDE is available on the user system because it 

system administrator to resolve problem. must be present to e-mail the completed registration form. 

Alternatively, users can print the form and fax or mail it. 


Form could not be printed: Dialog box is Check whether the printer is configured correctly, 
displayed requesting that the user see the Alternatively, user can e-mail form, 
system administrator to resolve problem. 


Form could not be saved: Dialog box is Check user’s home directory. Required action depends on 

displayed, verifying that registration the system configuration. 

succeeded; however, the registration 

information cannot be recalled when 

updating registration. 


Disabling User Registration 

If system administrators register for your organization, you may want to disable 
individual user registration as part of setting up user accounts. You can disable User 
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Registration either before or after installing Solaris software. Before Solaris software is 
installed, you can 

■ Deselect the SUNWsregu package (interactive installation). 

■ Modify a custom JumpStart profile to not install the SUNWsregu package. 

■ Create and rpn a finish script that creates a file named solregis which contains the 
line: disable=i in the /etc/default directory on one or more systems. 

After Solaris software is installed, you can 

■ Use the pkgrm command to remove the SUNWsregu package. 

■ Create a solregis file that contains the line DISABLE=i in the /etc/default directory. 
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HE SOLARIS 2.x ENVIRONMENT PROVIDES THREE SHELLS FOR USE AS COMMAND 
interpreters the Bourne shell (the default), the C shell, and the Korn shell. One 
shell is defined as the default shell for each user, but users can start a new shell 
from any command line. This chapter describes elements that are common to all 
three shells and then provides a section for each shell that describes some of the 
prevalent shell features. 


Table 8-1 lists the basic shell features and shows which shells provide each feature. 


Table 8-1 Basic Features of Bourne, C, and Korn Shells 


Feature 

Bourne 

C 

Korn 

Aliases 

No 

Yes 

Yes 

Command-line editing 

No 

Yes 

Yes 

Enhanced cd 

No 

Yes 

Yes 

History list 

No 

Yes 

Yes 

Ignore CTRL-D (ignoreeof) 

No 

Yes 

Yes 

Initialization file separate from .profile 

No 

Yes 

Yes 

Job control 

Yes 

Yes 

Yes 

Logout file 

No 

Yes 

No 

Protect files from overwriting (noclobber) 

No 

Yes 

Yes 

Syntax compatible with Bourne shell 

Yes 

No 

Yes 


Commands Common to All Shells 

The following sections describe commands that can be used with any shell. 



Setting a Default Shell 

The user’s login shell is set in the last field of the user’s entry in the Passwd database or 
/etc/passwd file. Use Solstice AdminSuite’s User Manager to edit the Passwd database. Use 
Admintool; Users to edit the local /etc/passwd file. To run Admintool on a local system, you 
must be a member of the sysadmin group (GID 14): 


1. Type admintooU and press Return to start Admintool (if necessary). 

2. Click on the user account you want to change. The user account is highlighted. 

3. From the Edit menu, choose Modify. The Admintool: Modify User window is displayed. 
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4. Choose the new login shell from the Login Shell menu. 

5. Click on the OK button. The next time the user logs out and logs in again, the new 
shell is used. 


Changing Shells from a Command Line {csh, ksh, sh) 

If you want to use another shell without modifying the Passwd database, you can change 
shells at a command line prompt by simply typing the name of the shell you want to use. 

To change to the C shell, type csh and press Return. The default C shell prompt is the 
system name followed by a percent sign (%); 

$ csh 
oak% 

To change to the Korn shell, type ksh and press Return. The default Korn shell prompt is a 
dollar sign ($); 

oak% ksh 
$ 

To change to the Bourne shell, type sh and press Return. The Bourne shell prompt also is a 
dollar sign ($): 

$ sh 
$ 

Quitting from a Sheil {exit) 

If you start a new shell from the command hne, you can quit it and return to the old shell. 
To quit from a shell, type exit and press Return. If you have started (layered) another 
shell, you are returned to the original shell prompt: 

$ exit 

oak% 

Ciearing a Sheii Window {clear) 

You can clear the contents of a shell window and redisplay the prompt to the top of the 
window. To clear the contents of a shell window, type clear and press Return: 

oak% which openwin 

no openwin in . /home/ignatz /usr/deskset/bin /usn/bin 
/home/ignatz/bin /bin /home/bin /etc /usr/etc /usn/ucb 
oak% clear 

The window is cleared and the prompt is redisplayed at the top. 
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The Bourne Shell 

The default shell for the Solaris 2.x environment is the Bourne shell, developed by Steve 
Bourne when he was at AT&T Bell Laboratories. The Bourne shell is a small shell for 
general-purpose use. It also provides a full-scale programming language that is used to 
develop shell scripts to capture frequently performed commands and procedures. 
Describing how to write shell scripts is beyond the scope of this book. 

Reviewing the Bourne Sheil Initiaiization Rie 

The Bourne shell uses one initialization file, .profile, in the user’s home directory to set 
the user’s environment. When the user logs in or starts a Bourne shell from the command 
line, the .profile file is read. Use this file to set the user’s path and any environment 
variables. 


Defining Bourne Sheli Environment Variables 

The syntax for defining an environment variable is the same for both the Bourne and Korn 
shells; type VA/IJMBLE= value-, export VARIABLE -dxA press Return. 

$ PS1=oak$;export PS1 
$ , 

The C Shell 

The C shell, written by Bill Joy when he was at UC-Berkeley, is popular with many users 
of Berkeley UNIX. The C shell is completely different from the Bourne and Korn shells 
and has its own syntax. The most important advantages of the C shell are command 
history, command editing, and aliases. Command history stores a record of the most 
recent commands that you have used. You can display these commands and reuse them as 
originally issued. You can also change a command by editing it. Aliases let you type short 
names for frequently used commands. You can also combine sequences of frequently 
used commands and provide an alias for the sequence. 

Reviewing C Shell Initialization Files 

The C shell uses two initialization files in the user’s home directory to set the user’s 
environment: . login and . cstirc (C shell run control). 

When the user logs in, the . login file is read, and then the . cshrc file. When you start the 
C shell from a command line, only the . cshrc file is read. Because the . login file is not 
always read, you should set environment variables and the user’s path in the . cshrc file. 




Defining C Shell Environment Variables 

To define an environment variable for the C shell, type setenv variable value and press 
Return: 

oak% setenv DISPLAY rogue:0 

oak% 


Creating Aliases for the C Shell 

Define any aliases for the user in the . cshrc file. The syntax for creating an alias is alias 
alias-name comand sequence. For example, you can shortcut the alias command so that 
you type only the letter a by adding this line to the .cshrc file: 

alias a alias 

Here are some examples of aliases from a . cshrc file. Note that if the command contains 
spaces, you enclose the entire command in quotes. In these examples, both double and 
single quotes are used: 

alias a alias 

a h history 

a c clear 

a If Is -F 

a 11 "is -1 I more" 

a la Is -a 

a s "source .cshrc" 

a f 'find ~ -name core -print' 

a copytotape "tar cvf /dev/rnit/0 *" 

Setting history for the C Sheii 

To set history for the C shell, on a command line type set history=/7 and press Return, 
history is set to the number of lines you specify: 

oak% set history=10 
oak% 

You can set history temporarily for a shell window or set it “permanently” so that the 
same history setting is available at each login session by entering the command as a line in 
your .cshrc file. 

Using history for the C Shell 

To display the history for the C shell, on a command line type history and press Return. 
The last n commands that you had set for the history are displayed; 

oak% history 

26 pwd 

27 kermit 

28 cd Howto 

29 tar xvf /dev/rii)t/0 

30 Is -1 howto* 
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31 cd 

32 cd Config/Art 

33 Is -1 

34 tar cvf /dev/rnit/0 

35 history 

oak% 

To repeat the previous command in a C shell, type 11 and press Return. The previous 
command is executed again: 

oak% history 


26 

pwd 

27 

kermit 

28 

cd Howto 

29 

tar xvf /dev/rnit/0 

30 

Is -1 howto* 

31 

cd 

32 

cd Config/Art 

33 

Is -1 

34 

tar xvf /dev/rmt/0 

35 

history 

oak% 11 


history 


27 

kermit 

28 

cd Howto 

29 

tar xvf /dev/rnit/0 

30 

Is -1 howto* 

31 

cd 

32 

cd Config/Art 

33 

Is -1 

34 

tar xvf /dev/rmt/0 

35 

history 

36 

history 


oak% 


To repeat the last word of the previous command in a C shell, type 1$ and press Return. 
The last word from the previous command is used as part of the command-line argument. 

For example, you might list the complete path name of a file, and then use the path name 
as the argument to edit the file using vi, or to print it: 

oak% Is -1 /home/ignatz/quest 
oak% Ip 1$ Ip 
/home/ignatz/quest 
oak% 

You can use the ! $ command anywhere within the command line. In this example, the file 
/home/ignatz/quest is copied to the /tmp directory: 

oak% Is -1 /home/ignatz/quest 
oak% cp 1$ /tmp 
cp /home/ignatz/quest /tmp 
oak% 

To repeat a numbered command in a C shell, type and press Return. The number in the 
shell prompt is n. The command is executed again. 
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oak% history 

29 tan xvf /dev/nfiit/0 

30 Is -1 howto* 

31 cd 

32 cd Config/Art 

33 Is -1 

34 tar xvf /dev/rmt/0 

35 Is -1 

36 cd 

37 Ip howto* 

38 history 
oak% 132 

cd Config/Art 
oak% 


Setting the Backspace Key for the C Shell [stty erase) 

If you want to change the erase key from Delete to Backspace, type stty erase, then 
press Control and Shift together, and then type H and press Return. The Backspace key is 
set as the erase key: 

oak% stty erase ''H 

oak% 


Incorporating a New Command for the C Shell {rehash) 

The C shell builds an internal table of commands named with the path variable. When 
you add a new command to a directory, the command is not part of the internal table and 
the shell cannot execute it. To incorporate a new command into the search path internal 
table, type rehash and press Return. Any new commands are incorporated into your 
command search path: 

oak% newcommand 

newcommand; Command not found 

oak% rehash 

oak% newcommand 

oak% 

Editing C Shell History Commands 

You can edit commands retrieved from the history list using the sioldstring/newstring/ 
form to substitute in the command as retrieved. In this example, an incorrectly typed 
command from the history list is corrected: 

oak% history 

31 cd 

32 Is 

33 cd /hotne/fnames. 1 

34 Is 

35 cd . . 

36 tar cvf /dev/rmt/0 frames.1 

37 Ip questionnaire 
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38 Ipstat -t 

39 echo $PaTH 

40 history 
oak% l39;s/a/A/ 
echo $PATH 

,:/home/winsor:/usr/openwin/bin:/usr/deskset/bin:/home/ 

winsor/bin:/bin:/home/bin:/etc:/usr/etc:/usr/bin:/home/ frarae3,l/bin 

oak% 


The Korn Shell 

The Kom shell, developed by David Korn of AT&T Bell Laboratories, is a superset of the 
Bourne shell. That is, the Kom shell uses the same syntax as the Bourne shell, but it has 
more built-in functions that can be defined directly from the shell. The Korn shell 
provides a more sophisticated form of command editing than does the C shell. The Kom 
shell also provides a command history and aliases. 

The Kom shell provides a complete command and programming language. The following 
sections provide a brief introduction to some of the most basic features of the Kom shell. 


Reviewing Korn Shell Initialization Files 

The Kom shell uses two initialization files in the user’s home directory to set the user’s 
environment: . profile and . ksh-env, which is a file with any name you choose that 
controls the user’s environment. You might want to name the file . kshrc, because its 
function is similar to the C shell .cshrc file. 

When the user logs in, the . profile file is read and then the .ksh-env file. The .ksh-env 
file lets you configure the Kom shell session to your needs. Many of the commands that 
you would include in the .ksh-env file can be executed only by the Kom shell and cannot 
be included in the .profile file. 

You must set the env environment variable to point to the. ksh-env file. The syntax for 
setting environment variables in the Kom shell is the same as for the Bourne shell: 
VARlABLE=value;export VARIABLE. As in the Bourne shell, you must export the variable to 
make it available to the shell. This example sets the environment variable for a . kshrc file: 

$ ENV=$HOME/.kshrc;export ENV 
$ 

You set this environment variable in the . profile file; otherwise, the . kshrc file will not 
be found when the user logs in. The env variable has no default setting. Unless you set it, 
the feature is not used. The .ksh-env file is read each time a user starts the Kom shell from 
a command line. 
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Using Korn Shell Options 

The Kom shell has a number of options that specify the user’s environment and control 
execution of commands. To display the current option settings, type set -o and press 
Return. In this example, the default options for the Kom shell for Solaris 2.x system 
software are displayed; 

$ set -0 

Current option settings 


allexport 

off 

bgnice 

on 

emacs 

off 

errexit 

off 

gmacs 

off 

ignoreeof 

off 

interactive 

on 

keyword 

off 

markdirs 

off 

monitor 

on 

noexec 

off 

noclobber 

off 

noglob 

off 

nolog 

off 

nounset 

off 

privileged 

off 

restricted 

off 

trackall 

off 

verbose 

off 

vi 

off 

viraw 

off 

xtrace 

off 


The default options are described in Table 8-2. Customarily, these options are set in the 
.ksh-env file. 


Table 8-2 

Korn Shell Options 

Option 

Default 

Description 

allexport 

off 

Automatically exports variables when defined. 

bgnice 

on 

Executes all background jobs at a lower priority. 

emacs 

off 

Sets emacs/gmacs as the in-line editor. 

errexit 

off 

If a command returns the value False, the shell executes the ERR trap (if set), 
and immediately exits. 

gmacs 

off 

Sets gmacs as the in-line editor. 

ignoreeof 

off 

When the interactive option is also set, the shell does not exit at end-of-file. 
Type exit to quit the shell. 
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Table 

Korn Shell Options (continued) 

Option 

Default 

Description 

interactive 

on 

The shell automatically turns the interactive option on so that shell prompts are 
displayed. 

keyword 

off 

The shell puts each word with the syntax of a variable assignment in the 
variable assignment list. 

markdirs 

off 

Displays a / following the names Kof all directories resulting from path name 
expansion. 

monitor 

on 

Enables job control. 

noclobber 

off 

Does not overwrite an existing file when the redirect operator (>) is used. 

noexec 

off 

Reads commands but does not execute them. You can use this option to debug 
shell script syntax errors. 

noglob 

off 

Disables file name expansion. 

nolog 

off 

Does not store function definitions in the history file. 

nounset 

off 

Displays an error message when the shell tries to expand a variable that is not 
set. 

privileged 

off 

When this option is off, the real UID and GID are used. When this option is on, 
the UID and GID are set to the values that were in effect when you started the 
shell. 

restricted 

off 

Sets a restricted shell. 

trackall 

off 

Makes command-tracked aliases when they are first encountered. 

verbose 

off 

Displays the input as it is read. 

vi 

off 

Sets vi as the in-line editor. 

viraw 

off 

Specifies character-at-a-time Input from vi. 

xtrace 

off 

Displays commands and arguments as they are executed. 


To enable an option, type set -o and press Return. To disable an option, 

type set +o option-name and press Return. 

For example, entering this line in the user’s . ksh-env file will set the in-line editor to vi: 
set -0 vi 

This turns off vi as the in-line editor; 
set +0 vi 

You can also set these options from a command line using the same syntax. 
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Creating Korn Shell Aliases 

The syntax for creating aliases for the Kom shell is alias name=value. This creates an alias 
for the alias command: 

$ alias a=alias 
$ 

This example aliases the history command to the letter h: 

$ a h=history 
$ 

The Kom shell comes with a default set of predefined aliases. To display the list, type 
alias and press Return: 

$ alias 

autoload=typeset -fu 
false=let 0 
functions=typeset -f 
hash=alias -t - 
history=fc -1 
integer=typeset -i 
nohup=nohup 
r=fc -e - 
stop=kill -STOP 
suspend=kill -STOP $$ 
true=: 

type=whence -v 
$ 

The default aliases are described in Table 8-3. 


Table 8-3 

Korn Shell Preset Aliases 

Allas 

Value 

Definition 

autoload 

typeset -fu 

Define an autoloading function. 

false 

let -0 

Return a nonzero status. Often used to ; 

functions 

typeset -f 

Display a list of functions. 

hash 

alias -t - 

Display a list of tracked aliases. 

history 

fc -1 

List commands from the history file. 

integer 

typeset -i 

Declare integer variable. 

nohup 

nohup 

Keep jobs running even if you log out. 

r 

fc -e - 

Execute the previous command again. 

stop 

kill -STOP 

Suspend job. 

suspend 

kill -STOP $$ 

Suspend job. 
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Table 8-3 Korn Shell Preset Aliases (continued) 

Allas Value Definition 

true : Return a zero exit status. 

type whence -v Display information about commands. 


Editing Commands with the Korn Sheli in-line Editor 

You can edit the current command before you execute it using the Korn shell in-line 
editor. You can choose one of three in-line editors; emacs, gmacs, or vi. The in-line editor 
is specified using the set -o editor option or by setting either the editor or visual 
environment variable. This section describes how to use the vi in-line editor to edit 
commands. 

The vi in-line editor is a modified subset of the vi program; it lacks some of the features 
of vi. The vi in-line editor is automatically in insert mode. You can type commands and 
execute them by pressing Return without using the vi in-line editor. If you want to edit a 
command, press Escape to enter command mode. You can move along the command line 
using the standard cursor movement commands, and use standard vi editing commands to 
edit the contents of the line. When the command is edited, press Return to execute it, or 
press Escape to return to input mode. 

If you want to edit the command line in a vi file, type v to open a vi file containing the 
contents of the command line. When you leave vi, the command is executed. Refer to 
Table 2-1, “Some Basic vi Commands” for a quick-reference table of common vi 
commands. 

Setting History for the Korn Shell 

The Korn shell stores history commands in a file specified by the histfile variable. If the 
variable is not set, the files are stored in $H0ME/ .sh_history. You can specify the number 
of commands stored using the histsize variable. If the variable is not set, the most recent 
128 commands are saved. When the history list contains the maximum number of 
commands, as new commands are entered, the oldest commands become unavailable. 

To set a different history size, type HISTSIZE=/7; export HISTSIZE and press Return. 

History is set to the number of lines you specify. 

In this example, the history size is set to 200: 

$ HISTSIZE=200;export HISTSIZE 

$ 

You can set the history temporarily for a shell window or set it “permanently” by entering 
the command as a line in the user’s . profile or . ksh - env file. 
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Displaying Korn Shell History Commands 

You can use two commands to show the commands from the history list: fc and history. 
Because history is aliased to fc -i as one of the default aliases, you can use the 
commands interchangeably. 

To display the last 16 commands in the history list, type history and press Return. The 
last 16 commands in the history list are displayed: 

$ history 

16 pwd 

17 ps -el 

18 ps -el I grep openwin 

19 cd 

20 more questionnaire 

21 su 

22 Ip /etc/passwd 

23 Ipstat -t 

24 man ksh 

25 du 

26 maker & 

27 tip -2400 5551212 

28 alias h=history 

29 find / -name ksh -print 

30 df -k 

31 history 

$ 

An alternative way to display the same information is to type fc -1 and press Return. 

The history and f c commands take additional arguments that let you specify a range, 
display the last n number of commands, and display the commands in reverse order. See 
the ksh(l) manual page for more information. 

Using Korn Shell History Commands 

To use a command from the history list, type r to reuse a command by number. This 
example would reuse command 27: 

$ r 27 

tip -2400 5551212 

(Connection messages are displayed) 

To repeat the last command in the history list, type r and press Return. 


Editing Korn Shell History Commands 

You can display individual history commands and edit them using the f c command, with 
this syntax: 

fc l-e <editQr>] [-r] [<range>] 
or this: 


fc -e - [<olcl>=<new>] [command] 
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You use the - e option to specify an editor. If no editor is specified, the fcedit environment 
variable value is used. If no value is set, the default editor is /bin/ed. The -r option 
reverses the order of the cojnmands, displaying the most recent commands at the top of 
the list. If no range is given, the last command is edited. 

For example, to use vi to edit the last command in a history list, type f c -e vi and press 
Return. A vi file is created containing the last entry from the histoiy list. When you edit 
the command and save the changes, the command is executed. 
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T his chapter describes commands that are specific to individual 

systems. It also shows how to configure additional swap space and how to 
create a local mail alias. 

Displaying System-Specific Information 

Use the commands in this section to find system-specific information such as the host ID 
number, hardware type, processor type, OS release level, system configuration, how long the 
system has been up, and system date and time. The following sections also describe how to 
set the system date and time and change the time zone for a system. 


Determining the Host iD Number (systfef-A) 

To find a system's host ID number, type sysdef -h and press Return. The host ID for the 
system is displayed. This command replaces the SunOS 4.x hostid command: 

oak% sysdef -h 
* 

* Hostid 

★ 

554095CC 

oak% 


Determining the Hardware Type {uname -m) 

To find the hardware type of a system, type uname -m and press Return. The hardware type 
(architecture) for the system is displayed. The SunOS 4 jc arch command, which provided 
similar information, is not available in SunOS 5 .t.' 

oak% uname -m 

sun4in 

oak% 


Determining the Processor Type {uname ~p) 

To find the processor type for a system, type uname - p and press Return. The processor type 
for the system is displayed. This command replaces the SunOS 4.x mach command: 

oak% uname -p 

spare 

oak% 


Determining the OS Release (uname -r) 

To find the OS release level for a system, type uname -r and press Return. The OS (kernel) 
release is displayed: 
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oak% uname -r 

5.6 

oak% 




Displaying System Configuration Information {prtconi) 

To display the configuration information for a system, type prtconf and press Return. The 
system configuration information is displayed: 

castle% prtconf 

System Configuration: Sun Microsystems sun4m 

Memory size: 64 Megabytes 

System Peripherals (Software Nodes): 


SUNW,SPARCstation-10 

packages (driver not attached) 

disk-label (driver not attached) 
deblocker (driver not attached) 
obp-tftp (driver not attached) 
options, instance #0 
aliases (driver not attached) 
openprom (driver not attached) 
iommu, instance #0 
sbus, instance #0 

espdma, instance #0 
esp, instance #0 

sd (driver not attached) 

St (driver not attached) 
sd, instance #@ (driver not attached) 
sd, instance #1 (driver not attached) 
sd, instance #2 (driver not attached) 
sd, instance #3 

sd, instance #4 (driver not attached) 
sd, instance #5 (driver not attached) 
sd, instance #6 (driver not attached) 
ledma, instance #0 
le, instance #0 

SUNW,bpp (driver not attached) 

SUNW,DBRIe (driver not attached) 
mmcodec (driver not attached) 
cgsix, instance #0 
obio, instance #0 
zs, instance #0 
zs, instance #1 
eeprom (driver not attached) 
counter (driver not attached) 
interrupt (driver not attached) 

SUNW,fdtwo, instance #0 
auxio (driver not attached) 
power (driver not attached) 
memory (driver not attached) 
virtual-memory (driver not attached) 
eccmemctl (driver not attached) 

TI,TMS390Z55 (driver not attached) 
pseudo, instance #0 
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{More information not shown in this example) 
castle% 

An alternative way to display system configuration information and show the state of 
tunable parameters is to type sysdef and press Return. System configuration information 
is displayed: 

castle% sysdef 
* 

* Hostid 

* 

727014d0 

* 

* sun4m Configuration 

* 

* 

* Devices 


packages (driver not attached) 

disk-label (driver not attached) 
deblocker (driver not attached) 
obp-tftp (driver not attached) 
options, instance #0 
aliases (driver not attached) 
openprom (driver not attached) 
iommu, instance #0 

sbus, instance #0 

espdma, instance #0 

esp, instance #0 

sd (driver not attached) 


St 

(driver not attached) 

sd, 

instance 

m 

(driver 

sd. 

instance 

#1 

(driver 

Sd, 

instance 

#2 

(driver 

sd. 

instance 

#3 


sd, 

instance 

#4 

(driver 

sd. 

instance 

#3 

(driver 

sd. 

instance 

#6 

(driver 


not attached) 
not attached) 
not attached) 

not attached) 
not attached) 
not attached) 


ledma, instance #0 

le, instance #0 
SUNW,bpp (driver not attached) 
SUNWjDBRie (driver not attached) 

mmcodec (driver not attached) 
cgsix, instance #0 
obio, instance #0 

2 s, instance #0 
zs, instance #1 
eeprom (driver not attached) 
counter (driver not attached) 
interrupt (driver not attached) 

SUNWjfdtwo, instance #0 
auxio (driver not attached) 
power (driver not attached) 
memory (driver not attached) 
virtual-memory (driver not attached) 
eccmemctl (driver not attached) 
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TI,TMS390Z55 (driver not attached) 
pseudo, instance #0 

clone, instance #0 
ip, instance #0 
tcp, instance #0 
udp, instance #0 
icmp, instance #0 
arp, instance #0 
sad, instance #0 
consms, instance #0 
conskbd, instance #0 
wc, instance #0 
iwscn, instance #0 
ptsl, instance #0 
tl, instance #0 
cn, instance #0 
mm, instance #0 
openeepr, instance #0 
kstat, instance #0 
log, instance #0 
sy, instance #0 
pm, instance #0 
vol, instance #0 
ptm, instance #0 
pts, instance #0 
ksyms, instance #0 

★ 

* Loadable Objects 

* 

genunix 

drv/arp 

hard link: strmod/arp 

drv/arp 

drv/be 

(More information not shown in this example) 

exec/aoutexec 

exec/elfexec 

exec/intpexec 

fs/cachefs 

fs/fifofs 

fs/hsfs 

fs/lofs 

fs/nfs 

hard link; sys/nfs 
fs/procfs 

fS/SQCkfs 

fs/specfs 

fs/tmpfs 

fs/ufs 

fs/autofs 

misc/consconfig 

misc/des 

misc/ipc 

misc/klmmod 

misc/klmops 

misc/krtld 
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misc/nfs_dlboot 

misc/nfssrv 

misc/rpcsec 

itiisc/rpcsec_gss 

misc/scsi 

{More information not shown in this example) 

sched/TS 

sched/TS_DPTBL 

strmod/bufmod 

strmod/connld 

strmod/dedump 

strmod/ldterm 

{More information not shown in this example) 

sys/c2audit 

sys/doorfs 

sys/inst_sync 

sys/kaio 

sys/msgsys 

sys/pipe 

sys/pset 

sys/semsys 

sys/shmsys 

* 

* System Configuration 

★ 

swap files 

swapfile dev swaplo blocks free 

/dev/dsk/c0t3d0s1 32,25 8 224096 224096 

■k 

* Tunable Parameters 

* 

1290432 maximum memory allowed in buffer cache (bufhwm) 

986 maximum number of processes (v.v_proc) 

99 maximum global priority in sys class (MAXCLSYSPRI) 

981 maximum processes per user id (v.v_maxup) 

30 auto update time limit in seconds {NAUTOUP) 

25 page stealing low water mark (GPGSLO) 

5 fsflush run rate (FSFLUSHR) 

25 minimum resident memory for avoiding deadlock (MINARMEM) 

25 minimum swapable memory for avoiding deadlock (MINASMEM) 

* 

* Utsname Tunables 


5.6 

castle 

SunOS 

Generic 


release (REL) 
node name (NODE) 
system name (SYS) 
version (VER) 


* Process Resource Limit Tunables (Current:Maximum) 

* 


ffffffffifffffffd 
ffffffffifffffffd 
ffffffff:fffffffd 
ffffffff:fffffffd 
0:7ffff000 
ffffffff:fffffffd 


cpu time 
file size 
heap size 
stack size 
core file size 
file descriptors 
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0: 800000 mapped memory 

* 

1 

* Streams Tunables 

* 


9 maximum number of pushes allowed (NSTRPUSH) 

65536 maximum stream message size (STRMSGSZ) 

1024 max size of ctl part of message (STRCTLSZ) 

1 * 

; 

* IPC Messages 

it 

i 

0 entries in msg map (MSGMAP) 

0 max message size (MSGMAX) 

0 max bytes on queue (MSGMNB) 

0 message queue identifiers (MSGMNI) 

0 message segment size (MSGSSZ) 

0 system message headers (MSGTQL) 

0 message segments (MSGSEG) 

* 


* IPC Semaphores 

* 

i 

i 

i 

I 

10 entries in semaphore map (SEMMAP) 

10 semaphore identifiers (SEMMNI) 

60 semaphores in system (SEMMNS) 

30 undo structures in system (SEMMNU) 

25 max semaphores per id (SEMMSL) 

10 max operations per semop call (SEMOPM) 

10 max undo entries per process (SEMUME) 

32767 semaphore maximum value (8EMVMX) 

16384 adjust on exit max value (SEMAEM) 

* 

1 

* IPC Shared Memory 

* 


1048576 max shared memory segment size (SHMMAX) 

1 min shared memory segment size (SHMMIN) 

100 shared memory identifiers (SHMMNI) 

6 max attached shm segments per process (SHMSEG) 

* 


* Time Sharing Scheduler Tunables 

* 


60 maximum time sharing user priority (fsMAXUPRI) 

SYS system class name (SYS_NAME) 

castle% 

! 

Determining How Long a System Has Been Up {uptime) 

To find out how long a system has been up, type uptime and press Return. The time, 
number of users, and load average are displayed for the local system: 

1 

castle% uptime 

1:16pm up 4:57, 1 user, load average: 0.12, 0.06, 0.04 

castle% 

i 

To find out when a system was booted, type who -b and press Return. The month, day, and 
time of the last boot are displayed: 
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oak% who -b 

. system boot Jul 14 08:49 
oak% 


Determining the System Date and Time (tfate) 

To display the system date and time, type date and press Return. The system date and 
time are displayed: 

castle% date 

Tue Sep 16 13:17:03 PDT 1997 
castle% 


Setting the System Date and Time (date) 

Follow these steps to reset the system date and time: 

6. Become superuser. 

7. Type date mmdt/hiimmyy and press Return, where mm is the month, dd is the day, hh is 
the hour, mm is, the minute, and yy is the year. The system date and time are reset 
using the month, day, hour, minute, and year that you specify: 

# su 

Password: 

# date 

Tue Jul 14 16:07:01 PST 1992 

# date 07141552 

Tue Jul 14 15:52:00 PST 1992 

# 

Changing the System Time Zone {/etc/TIMEZONE^ 

The time zone is set in the /etc/TiMEZONE file. The available U.S. time zone variables are 
shown below. Look in the /usr/share/ lib/zoneinf o directory for a complete list of time 
zone variables.: 

us /Arizona 

US/Central 

US/East-Indiana 

us/Hawaii 

US/Mountain 

US/Pacific 

US/Pacific-New 

us/Yukon 

Follow these steps to change the system time zone: 

1. Become superuser. 

2. Edit the /etc/TiMEZONE file, change the TZ=time-zone variable, and save the changes. 
The time zone is reset. 
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3. Reboot the system. 

Here is an example of the /etc/TiMEZONE file for a system set to Pacific Standard/Pacific 
Daylight Time. Note that /etc/TiMEZONE is now a symbolic link to /etc/default/init; 

castle% more /etc/TIMEZONE 

# @(#)init.dfl 1.2 92/11/26 

# 

# This file is /etc/default/init. /etc/TIMEZONE is a symlink to this file. 

# This file looks like a shell script, but it is not. To maintain 

# compatibility with old versions of /etc/TlMEZONE, some shell constructs 

# (i.e,, export commands) are allowed in this file, but are ignored. 

# 

# Lines of this file should be of the form VAR=value, where VAR is one of 

# TZ, LANG, or any of the LC_* environment variables. 

# 

TZ=US/Pacific 
castie% 

Here is an example of how to change the time zone from Pacific to Eastern; 

oak% su 
Password: 

# Vi /etc/TIMEZONE 
TZ=US/East-Indiana;export TZ 
:wl 

# reboot 
oak% date 

Tue Jul 14 14:24:52 EST 1992 
oak% 

NOTE. You may need to make your text editor do a confirmed write of the file. For exam¬ 
ple, in vi use the command .’w! to write the changes even if the permissions normally 
would not allow it. 


Configuring Additionai Swap Space {mkfile, swap) 

To create and add additional swap space without reformatting a disk, first you create a 
swap file using the mkf ile command. You can specify the size of the swap file in kilobytes 
(the default) or in blocks or megabytes by using the b and m suffixes, respectively. The 
swap file can either be on a local disk or be NFS-mounted. Then you add the swap space 
using the swap command. 

To list available swap files, type swap -l and press Return. A list of available swap files is 
displayed. The swap command replaces the SunOS 4.x swapon command: 

drusilla% swap -1 
swapfile 
swapfs 

/dev/dsk/c0t3d0s1 
drusilla% 

Follow these steps to create a swap file; 


dev swaplo blocks free 
0 94520 93512 

32,25 8 65512 45048 
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1. Become superuser. You can create a swap file without root permissions, but it is a 
good idea to have root be the owner of the swap file so that other processes cannot 
access it. 

2. Type mkfiie nnn\ k | b J m] flle-nme and press Return. The letter following the 
number you specify indicates kilobytes, blocks, or megabytes. The swap file of the 
size and file name you specify is created. In this example, you create a 1-Mbyte swap 
file named swap: 

oak% su 
Password: 

# mkfiie 1m /files1/SWAP 

# 

Follow these steps to add the swap file: 

1. Become superuser. 

2. Type swap -a path-name and press Return. You must use the absolute path name to 
specify the swap file. The swap file is added and available. 

3. Type swap -1 to verify that the swap file is added. 

# swap -a /filesl/SWAP 

# swap -1 


swapfile 

swapfs 

dev 

swaplo 

0 

blocks 

94520 

free 

93512 

/dev/dsk/c0t3d0s1 

32,25 

8 

65512 

45048 

/filesl/SWAP - 8 

2040 

2040 




# 

Follow these steps to remove a specified swap file from use: 

1. Become superuser. 

2. Type swap -d path-name and press Return. When the swap file is no longer in use, it 
is removed from the list so that it is no longer available for swapping. The file itself 
is not deleted: 

oak% su 
Password: 

# swap -d /files!/SWAP 

# swap -1 

swapfile dev swaplo 

blocks free 

swapfs - 0 

94520 93512 

/dev/dsk/c0t3d0s1 32,25 8 

65512 45048 

# Is '1 /filesl/SWAP 

-rw. 1 root root 

# 


1048576 Jan 31 13:56 SWAP 
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When you create additional swap space, if you want the swap space to remain available 
when the system is rebooted, you must add the entry to the /etc/vfstab file. Follow these 
steps to add a swap file entry to the / etc/vf stab file: 

1. Become superuser. 

2. Edit the/etc/vf stab file and add this line:- - swap - no -.Be sure the 
line follows the entry for the partition where the swap file was created. 

The next time the system is rebooted, the swap file is added automatically. 

The following example adds the swap file /f ilesl /swap to the /etc/vf stab file after the 
entry that mounts the file system /f ilesl; 

/files1/SWAP - - swap - no - 


Creating a Local Mail Alias {/etc/mail/aliases) 

In a network environment, you probably have a central way to administer mail aliases. In 
addition, users frequently want to set up local aliases for use from their systems. Follow 
these steps to create mail aliases on a local system: 

1. Become superuser. 

2. Edit the/etc/mail/aliases file. 

3. At the end of the file, under the Local Aliases category, type 
aliasname^usernamet,usernames ,... and press Return after the last username. 

4. Save the changes. 

For example, if you want to create an alias called friends, edit the /etc /mail / aliases file 
and add an entry like this: 

friends:dexten@elm,ogden@willow,mary@maple 
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Recognizing Problems with Search Paths 


T his chapter describes how to recognize problems with search paths, 
permissions, and ownership. 

Users frequently experience problems—and call on a system administrator for help—^because 
they cannot access a program, a file, or a directory that they used to be able to access. 
Whenever you encounter such a problem, investigate one of two areas: 

■ The user’s search path may have been changed, or the directories in the search path may 
not be in the proper order. 

■ The file or directory may not have the proper permissions or ownership. 

This chapter briefly describes how to recognize problems in each of these areas and suggests 
possible solutions. 


Recognizing Probiems with Search Paths 

If a user types a command that is not in the search path, the message command not found is 
displayed. The command may not be found because the command is not available on the 
system or the command directory is not in the search path. 

If the wrong version of the command is found, a directory with a command of the same name 
is in the search path. In this case, the proper directory may be found later in the search path 
or may not be present at all. 

To diagnose and troubleshoot problems with search paths, follow this procedure: 

1. Display the current search path. 

2. Edit the file where the user’s path is set (. cshrc or . login for the C shell; . profile for 
the Bourne and Korn shells). Add the directory, or rearrange the order of the path. 

NOTE. For the C shell, always check both the .cshrc and .login files to make sure the 
path information is set all in one place. Duplicate entries can make the search path hard to 
troubleshoot and make search times less efficient for the user. 

3. Source the file to activate the changes. 

4. Verify that the command is found in the right place. 

5. Execute the command. 

The tasks you use to follow this procedure are described in the following sections. 
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Displaying the Current Search Path 

To display the current search path, type echo $PATH and press Return. The current search 
path is displayed: 

cinderella% echo $PATH 
/sbin:/usr/sbin:/usr/bin:/etc 
Cinderella^ 


Setting the Path for Bourne and Korn Shelis 

The path for the Bourne and Korn shells is specified in the user’s $home/ .profile file in 
this way: 

PATH=/usr/bin:/$HOME/bin:.;export PATH 

The dot (.) at the beginning of the path specifies that the current directory is always 
searched first. 


Sourcing Bourne and Korn Shell Dot Files 

When you have changed information in the . profile file, you must source the file 
to make the new information available to the shell To source the . profile file, type 
. . profile and press Return: 

$ . .profile 

$ 


Setting the Path for the C Shell 

The path for the C shell is specified in the user’s $home/ . cshrc or . login file (with the 
set path environment variable) in this way: 

set path = (/usr/bin Shome/bin .) 

The dot (.) at the beginning of the path specifies that the current directory is always 
searched first. 


Sourcing C Sheil Dot Fiies 

When you have changed information in the . cshrc or .login file, you must source the 
file to make the new information available to the shell. To source the . cshrc file, type 
source .cshrc and press Return. To source the .login file, type source .login and press 
Return: 

castle% source .cshrc 
castle% source .login 
castle% 
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Verifying the Search Path 

When you have changed a user’s path, use the which command to verify that the shell is 
finding the proper command. The which command looks in the . cshrc file for 
information. The which command may give misleading results if you execute it from the 
Bourne or Korn shell and the user has a . cshrc file that contains aliases for the which 
command. To ensure accurate results, use the which command in a C shell. Alternatively, 
you can use the whence command instead of the which command from the Kom shell. 

To verify the search path, type which coamand-name and press Return. If the command is 
found in the path, the path and the name of the command are displayed. 

This example shows that the OpenWindows executable is not in any of the directories in 
the search path: 

oak% which openwin 

no openwin in . /home/ignatz /sbin /usr/sbin /usr/bin /etc /home/ignatz/bin 

/bin /home/bin /usr/etc 

oak% 

This example shows that the executable for OpenWindows is found among the directories 
in the search path; 

oak% which openwin 

/usr/openwin 

oak% 

If you cannot find a command, look at the manual page. For example, if you cannot find 
the ipsched command (the LP printer daemon), the ipsched(lM) manual page tells you 
thepathis /usr/lib/lp/lpsched. 


Executing a Command 

To execute a command, type ctuaaand-nama and press Return. The conunand is executed if 
it is in the search path. You can always execute a command that is not in the search path 
by typing the full path name for the command. 


Recognizing Problems with Permissions and 
Ownership 

When users cannot access files or directories that they used to be able to access, the most 
likely problem is that permissions or ownership on the files or directories has changed. 

Frequently, file and directory ownerships change because someone edited the files as root. 
When you create home directories for new users, be especially careful to make the user 
the owner of the dot (.) file in the home directory. When users do not own the dot (.) files, 
they cannot create files in their own home directory. 
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Another way access problems can arise is when the group ownership changes or when a 
group that a user is a member of is deleted from the /etc /groups database. 

Changing File Ownership 

NOTE. You must own a file or directory (or have root permission) to be able to change 
its ownership. 

Follow these steps to change file ownership: 

1. Type Is -1 file-name and press Return. The owner of the file is displayed in the 
third column. 

2. Become superuser. 

3. Type chown new-owner fUe-naae and press Return. Ownership is assigned to the 
new owner you specify, in this case, ignatz: 

oak% Is -1 quest 

-rw-r--r-- 1 fred staff 6023 Aug 5 12:06 quest 

oak% su 

Password: 

# chown ignatz quest 

# Is -1 quest 

-rw-r--r-- 1 ignatz staff 6023 Aug 5 12:06 quest 

# 

Changing File Permissions 

You use the chmod command to change file permissions. You can change permissions in 
two ways. If you use letters, use this syntax; 

chmod [who]operaf-or[permission(s)] file-name 

For who, you can specify u, g, or o (for user, group, or other). You can specify a to change 
all operators. If you do not specify who permissions are for, permissions are changed for 
all three groups. The operator is either + to add permission or - to take away permission. 
The permissions are r, w, or x, for read, write, or execute. See the chmod(l) manual page 
for more permissions. 

For example, to grant read, write, and execute permissions to everyone, type chmod +wrx 
and press Return: 

oak% chmod +wrx dog 
oak% Is -1 dog 

-rwxrwxrwx 1 janice staff 54 Jul 7 11:33 dog 

oak% 

To grant read and execute permissions to everyone, type chmod +rx file-name and press 
Return: 

oak% chmod +rx dog 
oak% Is -1 dog 


i 
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-r-xr-xr-x 1 Janice staff 54 Jul 7 11:34 dog 
oaK% 

Another way to change the permissions to read and execute only would be to deny write 
permission to everyone. Type chmod -w file-name and press Return: 

oak% chmod -w dog 
oak% Is -1 dog 

-r-xr-xr-x 1 Janice staff 54 Jul 7 11:35 dog 

oak% 

To change ownership for a specific group, type the letter for the group followed by the 
operator and the permission. In the following example, read, write, and execute 
permissions have been granted for the owner to the file dog: 

oak% chmod u+wrx dog 
oak% Is -1 dog 

-rwxr-xr-x 1 Janice staff 54 Jul 7 11:36 dog 

oak% 

To deny execute permissions to group and other, type chmod go-x flle-Bamo and press 
Return. 

oak% chmod go-x dog 
oak% Is -1 dog 

-rwxr--r-- 1 Janice staff 54 Jul 7 11:37 dog 

oak% 

You can also use a numeric argument with the chmod command that describes the user 
class and permission to change as a sequence of bits. Table 10-1 shows the octal values 
for setting file permissions. You use these numbers in sets of three to set permissions for 
owner, group, and other. For example, the value 644 sets read/write permissions for owner, 
and read-only permissions for group and other. 


Table 10-1 

Octal Values for File Permissloos 

Value 

Description 

,0 

No permissions 

1 

Execute-only 

2 

Write-only 

3 

Write, execute 

4 

Read-only 

5 

Read, execute 

6 

Read, write 

7 

Read, write, execute 





274 


Recocnizinq File Access Problems 


Follow these steps to change permissions on a file: 

1. Type Is -1 WJe-yyaAfe and press Return. The long listing shows the current 
permissions for the file. 

2. Type chmod nnn fileoaae and press Return. Permissions are changed using the 
numbers you specify. 

NOTE. You can change permissions on groups of files or on all files in a directory using 
metacharacters such as * and ? in place of file names or in combination with them. 

This example changes the permissions of a file from 666 (read/write, read/write, 
read/write) to 644 (read/write, read-only, read-only): 


oak% Is -1 

quest 





-rw-rw-rw- 

1 ignatz 

staff 

6023 Aug 

5 12:06 

quest 

oak% chmod 

644 quest 





oak% Is -1 

quest 





- rw - r ■ - r - - 

1 ignatz 

staff 

6023 Aug 

5 12:06 

quest 


oak% 


Changing File Group Ownership 

If a file has an incorrect group owner, users of the group will not be able to make changes 
to the file. To change file group ownership, you must either be a member of the group, 
own the file, or change it as root. 

To change the group ID for a file, type chgrp gid filenaae and press Return. The group 
ID for the file you specify is changed. With Solaris 2x, the is -1 command shows the 
owner and the group for the file. You can display only the group owner using the is -ig 
command: 

$ Is -Ig junk 

-rw-r--r-- 1 other 0 Oct 31 14:49 junk 

$ chgrp 10 Junk 
$ Is -Ig junk 

-rw-r--r-- 1 staff 0 Oct 31 14:49 junk 
$ 

The group ID is found in the Group database or the local /etc/group file. 
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Installation and Configuration 


T his appendix summarizes the major differences between the SunOS 4.x 
and SunOS 5.x operating systems in these areas: 

■ Installation and configuration 
■ Startup and shutdown 
■ Filesystems 

■ Printers, terminals, and modems 
■ Naming services 
■ TCP/IP 
■ UUCP 

■ Document tool differences 
■ Security 

The last section in this appendix contains an alphabetical list of SunOS 4.x commands and 
shows the equivalent SunOS 5.x command, if one is available. 

Instaillation and Configuration 

Solaris 2.x software is distributed on compact disc (CD-ROM) only. You must have access to 
a CD drive before you can install the software. However, because you can set up a system to 
act as a remote server when installing the software on systems without local CD drives, you 
need access to only one CD drive on the network. 

Solaris 2.x software is bundled into modules called packages. You can select packages that 
are relevant to your system and control the amount of space each installation requires. 
Sometimes packages are grouped into clusters so that you can install a set of packages for 
typical users, developers, or system administrators without selecting each package separately. 

SunOS 5.x software includes architecture-specific kernels, rather than the generic kernel 
configuration provided in earlier SunOS software releases. You will find the installed kernel 
in ; kernel/Unix instead of /vmunix. 

You no longer need to manually configure and build new kernels. When you install new 
device drivers and boot the system using the boot - r command, the kernel dynamically 
reconfigures itself. 

When you boot the installation CD, a utility called sysidtool checks network databases for 
system configuration information. The sysidtool utility uses the information it finds and 
prompts you to enter other required information. 
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What Is Installed on a SunOS 5.x System 

The / var/sadm /install /contents file lists every file that installation puts onto the 
system. To find out if a specific file was installed, look through /var/sadin/install/ 
contents to see if the file is listed. The file contains the complete path, the ownership and 
protection of the file, and the package from which the file was installed. For example, to 
display information about the printf file, type # grep printf 
/var/sadm/install /contents. Your screen will look like this; 

# grep printf /var/sadm/install/contents 

/usr/bin/printf f none 0555 bin bin 11628 1694 869027018 SUNWloc 
/usr/share/man/manl/printf.1 f none 0444 bin bin 10827 6685 867348047 SUNWman 
/usr/share/nian/man3b/fprintf.3b f none 0444 bin bin 57 3974 867349873 SUNWman 
/usr/share/man/man3b/printf.3b f none 0444 bin bin 11825 25632 867349885 SUNWman 
/usr/share/man/man3b/sprintf.3b f none 0444 bin bin 57 3987 867349912 SUNWman 
/usr/share/man/man3b/vfprintf.3b f none 0444 bin bin 58 4092 867349923 SUNWman 
/usr/share/man/man3b/vprintf.3b f none 0444 bin bin 57 3990 867349924 SUNWman 
/usr/share/man/man3b/vsprintf.3b f none 0444 bin bin 58 4105 867349926 SUNWman 
/usr/share/man/man3c/wsprintf.3c f none 0444 bin bin 1635 4399 867350689 SUNWman 
/usr/share/man/man3s/fprintf.3s f none 0444 bin bin 57 4025 867352286 SUNWman 
/usr/share/man/man3s/printf.3s f none 0444 bin bin 18972 20693 867352330 SUNWman 
/usr/share/man/man3s/snprintf.3s f none 0444 bin bin 58 4145 867352353 SUNWman 
/usr/share/man/man3s/sprintf.3s f none 0444 bin bin 57 4038 867352355 SUNWman 
/usr/share/man/man3s/vfprintf.3s f none 0444 bin bin 59 4261 867352371 SUNWman 
/usr/share/man/man3s/vprintf.3s f none 0444 bin bin 4365 34455 867352374 SUNWman 
/usr/share/man/man3s/vsnprintf.3s f none 0444 bin bin 60 4381 867352376 SUNWman 
/usr/share/man/man3s/vsprintf.3s f none 0444 bin bin 59 4274 867352376 SUNWman 
/usr/share/man/man9f/sprintf.9f f none 0444 bin bin 3571 42682 867356508 SUNWman 
/usr/share/man/man9f/vsprintf.9f f none 0444 bin bin 5193 43812 867356551 
SUNWman 

# 

NOTE. When you complete system installation, you may need to type the boot ■ r com¬ 
mand to reconfigure the device names and modules so that they work with Solaris 2.x. 


Startup and Shutdown 

SunOS 5,x system software has eight initialization states (init states or run levels). The 
default init state is defined in the /etc/inittab file. See “Choosing an Init State” in 
Chapter 1 for a description of the initialization states. 

The shutdown command works differently than in the SunOS 4.x version. The SunOS 4.x 
f astboot and f asthalt commands are available only on SunOS 5.x systems with BSD 
source compatibility package installed. 

The halt and reboot commands (not found in AT&T SVR4 systems) have shutdown and 
init equivalents. It is recommended that you use them because halt and reboot do not 
run the rc scripts properly. 
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The init command uses a different script for each run level instead of grouping all the run 
levels together in the /etc/rc, /etc/rc.boot, and /etc/rc.local files. The files, named 
by run level, are located in the /sbin directory. 

Here is a list of the default run control scripts in the /sbin directory; 


castle% Is 

■1 

/sbin/rc* 







-rwxr--r-- 

3 

root 

sys 

1776 

Jan 

1 

1970 

/sbin/rc0 

-pwxr--r- - 

1 

root 

sys 

1159 

Jan 

1 

1970 

/sbin/rcl 

-rwxn--r-- 

1 

root 

sys 

1545 

Jan 

1 

1970 

/sbin/rc2 

-rwxr--r-- 

1 

root 

sys 

927 

Jan 

1 

1970 

/sbin/rc3 

-rwxr- -r- - 

3 

root 

sys 

1776 

Jan 

1 

1970 

/sbin/rc5 

-rwxr--r-- 

3 

root 

sys 

1776 

Jan 

1 

1970 

/sbin/rc6 

-rwxr--r-- 

1 

root 

sys 

6919 

Jan 

1 

1970 

/sbin/rcS 


castle% 

NOTE. The / sbin / rc directory now contains an rcS script used to bring the system to 
single-user mode. For more information, see “The rcS Script” later in this appendix. 

Run control files are located in the /etc / init ,d directory. These files are linked to 
corresponding run control files in the /etc / rc /etc and / etc / rc*. d directories. The files 
in the /etc directory define the sequence in which the scripts are performed within each 
run level. For example, / etc / rc2. d contains files used to start and stop processes for run 
level 2. 

castle% Is /etc/rc2.d 


K20spc 

S47asppp 

S74syslog 

S89bdconfig 

K60nfs.server 

S69inet 

S74xntpd 

S91agaconfig 

K76snttipdx 

S70UUCP 

S75cron 

S9lleoconfig 

K77dnii 

S71rpc 

S76nscd 

S92rtvc-config 

README 

S71sysid.sys 

S80PRESERVE 

S92volingt 

S01MOUNTFSYS 

S72autoinstall 

S801p 

S93cacheos.finish 

S05RMTMPFILES 

S72inetsvc 

S80spc 

S99audit 

S20sysetup 

S73cachefs,daemon 

S85power 

S99dtlogin 

S2lperf 

S73nfs.client 

S88sendmail 


S30sysid.net 

S74autofs 

SBSutmpd 



castke% 

The scripts are always run in ASCII sort order. The names of the scripts are names of the 
forms [K,S][0-9][A-Z][0-99]. Files beginning with K are run to terminate (kill) some 
system process. Files beginning with S are run to start up a system process. The actions of 
each run control level script are summarized in the following sections. 


The rcO Script 

■ Stops system services and daemons 

■ Terminates all running processes 

■ Unmounts all file systems 
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H castle% Is /etc/rc0.d 

K00ANNOUNCE K47asppp K66nfs. server K73volingt 

K10cltlogin K50uti!ipd K69autofs K75nfs. client 

K2Clp KSSsyslog K69xntpd K76nscd 

K42audit K57sendniail K70cron K85rpc 

castle% 


The rcX Script 

■ Runs the /etc/rci .d scripts 

■ Stops system services and daemons 

■ Terminates all running processes 

■ Unmounts all file systems 

■ Brings the system up in single-user mode 


i M 

castle% Is 

/etc/rci.d 



K00ANNOUNCE 

K47asppp 

K65nfs.server 

K70cron S01MOUNTFSYS 


K10dtlogin 

K50utinpd 

K67rpc 

K76nscd 


K201p 

KSSsyslog 

K68autofs 

K80nfs.client 


K42audit 

castle% 

K57sendmail 

K69xntpd 

K85power 


The rc2 Script 

■ Sets the timezone variable 

■ Runs the / etc / rc2. d scripts 

■ Mounts all file systems 

■ Saves editing files in/usr/preserve 

■ Removes any files in the /tmp directory 

■ Creates device entries in/dev for new disks (only if boot -r is run) 

■ Updates device. tab device table 

■ Prints system configuration (the default is not to save core) 

■ Configures system accounting 

■ Configures default router 

■ Sets NIS domain 

■ Sets ifconf ig netmask 

■ Starts inetd 

■ Starts named, if appropriate 
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■ Starts rpcbind 

■ Starts Kerberos client-side daemon, kerbd 

■ Starts NIS daemons (ypbind) and NIS-i- daemons (rpcnisd), depending on whether the 
system is configured for NIS or NIS+, and as a client or a server 

■ Starts keyserv 

■ Starts statd, lockd 

■ Mounts all NFS entries 

■ Starts autoiTiount 

■ Starts cron 

■ Starts the LP daemons 

■ Starts the sendmali daemon 

castle% Is /etc/rc2.d 


K20spc 

S47asppp 

S74syslog 

S89bdconfig 

K60nfs.server 

S69inet 

S74xntpd 

S91agaconfig 

K76snnipdx 

S70UUCP 

S75cron 

S911eoconfig 

K77diiii 

S71rpc 

S76nscd 

S92rtvc-config 

README 

S71sysid.sys 

S80PRESERVE 

S92volmgt 

S01MOUNTFSYS 

S72autoinstall 

S801p 

S93cacbeos,finish 

S05RMTMPFILES 

S72inetsvc 

S80spc 

S99audit 

S20sysetup 

S73cachefs.daemon 

SSSpower 

S99dtlogin 

S21perf 

S73nfs.client 

SSSsendmail 


S30sysid.net 

S74autofs 

SSSutmpd 



castle% 

The rc3 Script 

■ Runs the /etc/rc3.d scripts 

■ Starts syslogd 

■ Cleans up sharetab 

■ Starts nf sds 

■ Starts mountd 

■ If boot server, starts rarpd and rpc.bootparamd 

■ Starts nis_cacheinanager 

■ Starts rpc. nisd 

■ Starts RFS services, if configured 






castle% Is /etc/rc3.d 

README S15nfs. server S76snrnpclx S77clnii 

castle% 

The rcS Script 

■ Runs the / etc / rcB, d scripts 

■ Kills the printer daemons 

■ Unmounts local file systems 

■ Kills the syslog daemon 

■ Unmounts remote file systems 

■ Stops RFS services 

■ Stops NFS services 

■ Stops NIS services 

■ Stops rpc services 

■ Stops croii services 

■ Stops NFS client services 

■ Kills all active processes 

■ Initiates an interactive boot (boot -a) 

The rc6 Script 

■ Executes /etc/rc0.d/K* 

■ Kills all active processes 

■ Unmounts the file systems 

■ Executes the initdefault entries in / etc / inittab 

The rcS Script 

After the S30 scripts have executed, the / and /usr (if present) file systems are mounted 
read-only. Enough network plumbing has been established to perform an NFS mount of 
/usr. 

The sequence range S31-S39 can depend upon these file systems being read-only. No 
other file systems are mounted by the Solaris product. 

After the S60 scripts have executed, all system supplied device file names have been 
established. Therefore, the preferred range for the creation of file names for third-party 
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devices is the range S61-S79, however, they may be done anywhere in the S61-S99 range. 
The environment symbol _init_reconfig is the key to a reconfiguration boot. Also, the 
base system mounts have been performed and those file systems are read/write if so 
specified. The base system mounts are; 

/ 

/usr 

/proc 

/dev/fd 

The following file systems can be assumed to be writable; 

/dev (for logical name creation) 

/devices (for physical name creation) 

/etc (for mnttab and file administration) 

After the S 80 scripts have executed, any other file systems to be mounted in single-user 
mode are mounted. Currently these are /var and /var/adm. 

castle% Is /etc/rcs.d 

S33keymap.sh S60devlinks 

S35cacheos.sh SeSpcmcia 

S40standardmounts.sh S70buildmnttab.sh 
S41cachefs.root 
S50drvconfig 


describe changes to the file systems. 


K65pcnicia 

README 

S00sxcmeni 

S10initpcnicia 

S30rootusr.sh 

castle% 


File Systems 

The following sections 


NFS and RFS 

Solaris 2.x software includes a common set of commands and files to administer both 
network file system (NFS) and remote file sharing (RFS) resources. This set of commands 
is called distributed file system (DFS) administration. The common DFS commands 
replace the separate NFS and RFS commands required in SunOS 4.x systems, and 
simplify NFS and RFS resource sharing because it is necessary to remember only one set 
of commands. See Chapter 4, “Administering File Systems,” for more information about 
file system commands. 

Directory Changes 

The directory structure is changed. The following sections provide an overview of file and 
directory information. If you cannot locate a familiar file or directory, it may not be 
available or its contents may be relocated. 
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Addition of the /opt Directory 

The /opt directory contains optional add-on application software packages. These 
packages were installed in /usr on SunOS 4.x systems. Keeping them in /opt leaves the 
/usr directory stable as packages are installed and removed. 


Addition of the /proc Directory 

The /proc directory contains a numerical list of processes. Information in the /proc 
directory is used by commands such as ps. Debuggers and other development tools can 
also access the address space of the processes by using file system calls. 

Addition of the /devices directory 

The /devices directory contains character and block special device files. Here is an 
example of the contents of the /devices directory: 

oak% Is -1 /devices 
total 12 


crw-rw-rw- 

1 root 

sys 

28, 

128 Aug 

3 

15:10 audio@1,f7201000:audioctl,0 

crw. 

1 root 

sys 

68, 

IT Aug 

3 

13:56 eeprom@l,f2000000:eeprom 

brw-rw-rw- 

1 root 

sys 

36, 

0 Aug 

3 

13:56 fdOl,f7200000:a 

crw-rw-rw- 

1 root 

sys 

36, 

0 Aug 

3 

13:56 fd@1,f7200000:a,raw 

brw-rw-rw- 

1 root 

sys 

36, 

1 Aug 

3 

13:56 fdei,f7200000:b 

crw-rw.-rw- 

1 root 

sys 

36, 

1 Aug 

3 

13:56 fd@1,f7200000:b,raw 

brw-rw-rw- 

1 root 

sys 

36, 

2 Aug 

3 

13:56 fd01,f7200000:c 

crw-rw-rw- 

1 root 

sys 

36, 

2 Aug 

3 

13:56 fd@1,f7200000:c,raw 

drwxrwxrwx 

2 root 

sys 

4608 Aug 

3 

.15:10 pseudo 

drwxrwxrwx 

3 root 

sys 


512 Aug 

3 

13:56 sbuslPI ,f8000000 

crw-rw-rw- 

1 root 

sys 

29, 

0 Aug 

3 

13:56 zs@1,f1000000:a 

crw-rw-rw- 

1 root 

sys 

29, 

131072 Aug 

3 13:56 zs@1,f1000000:a,cu 

crw-rw-rw- 

1 root 

sys 

29, 

1 Aug 

3 

13:56 zs@1,f1000000:b 

crw-rw-rw- 

1 root 

sys 

29,131073 Aug 

3 13:56 zs®1,f1000000:b,cu 


oak% 



Addition of the /kernel Directory 

The / kernel directory contains the UNIX kernel and kernel-level object modules. 
Table A-1 describes the subdirectories that have been added to the / kernel directory. 


x86 systems also have a mach directory that contains x86 hardware support. 


Table A-1 Contents of the /kernel Directory 

Directory Description 


drv 
exec 
f s 


Loadable device drivers 

The modules that execute programs stored in various file formats 
File system modules 





Table A-1 


Contents of the /kernel Directory (continued) 

misc Miscellaneous system-related modules 

sched Operating system schedulers 

strmod System V STREAMS loadable modules 

sys Loadable system calls 

Changes in the /dev Directory 

The /dev directory is changed from a flat directory to a hierarchical one. Table A-2 shows 
the added subdirectories. 


Table A-2 

Additions to the /dev Directory 

Directory 

Description 

/dev/dsk 

Block disk devices 

; /dev/pts 

Pseudo terminal (pty) slave devices 

/dev/rdsk 

Raw disk devices 

/dev/rmt 

Raw tape devices 

I /dev/sad 

t 

Entry points for the STREAMS administrative driver 

1 /dev/term 

Terminal devices 


Changes in the /etc Direidcory 

The /etc directory contains system-specific configuration information. Several files and 

subdirectories are added, removed, or changed from the SunOS 4.x /etc directory: 

■ File system-specific commands, such as mount_rf s, are moved to the /usr/ lib/f s 
directory. 

m The /etc/f stab file is replaced with /etc/vfstab. 

■ Initialization scripts, such as rc, rc. boot, rc. local, and rc. single, are not available in 
the SunOS 5.x release. 

■ Mail commands that used to be in the /etc directory are moved into the new 
/etc/mail directory. 

Table A-3 describes the subdirectories that have been added to the / etc directory. 




Table A-5 Files Moved from the /usr Directory 


SunOS 4.x Location SunOS 5.x Location 

/usr/5bin /usr/bin 

/usr/Sinclude /usr/include 
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Table A-5 Files Moved from the /iisr Directory (continued) 


SunOS 4.x Location 

/usr/51ib 

/usr/etc 

/usr/rfs 

/usr/old 

/usr/xpg2bin 

/usr/xpg21ib 

/usr/xpg2include 


SunOS 5.x Location 

/usr/lib 
/usr/sbin 
/etc/rfs 
Contents removed 
/usr/bin 
/usr/lib 
/usr/include 


Changes in the /var Directory 

The / var directory contains files whose sizes change during normal operation. Several 
files and subdirectories in the /var directory are added, removed, or changed: 

■ The /var/opt/pac/capename directory contains software package objects whose sizes 
change, such as log and spool files. 

■ The / var/sadm directory contains databases that are maintained by the software 
package management utilities. 

■ The /var/saf directory contains SAP logging and accounting files. 

■ The / var/spool/mail directory has been moved to /var/mail. 


Device-Naming Conventions 

The SunOS 5.x release uses device-naming conventions that make it easier to infer certain 
characteristics of a device from its device name. The SunOS 5.x conventions are slightly 
different from AT&T SVR4 device names, because the SunOS 5.x release only allows 
eight partitions on a disk. 

You must use SunOS 5.x device-naming conventions with SunOS 5.x commands. 
However, if the binary compatibility package is installed, it creates links from the old 
device-naming conventions to the new ones, and you can continue to use SunOS 4.x 
device names. See Chapter 3, “Administering Devices,” for a description of device-naming 
conventions. 

Table A-6 shows some examples that compare the SunOS 4.x and SunOS 5.x 
device-naming conventions. 



288 


Major Differences: SunOS 4.x Versus SunOS 5.x Operating Systems 


I 


Table A-6 SunOS 4.x and SunOS 5.x Device Names 


Device Description 

Disk devices 


Tape devices 

CD-ROM device 


SunOS 4.x 

SunOS 5.x 

/dev/sd0g 

/dev/dsk/c0t3d0s6 

/dev/rsd3b 

/dev/rdsk/c0t0d0s1 

/dev/rsd3a 

/dev/rdsk/c0t0d0s0 

/dev/nrmtS 

/dev/rmt/Bhn 

/dev/rst0 

/dev/rmt/0h 

/dev/sr0 

/dev/dsk/c0t6d0s2 


1 


Printers, Terminals, and Modems 

Solaris 2.x software includes the SAP, which is used to manage access to local and 
network system services (such as printers, modems, and terminals) in a similar way, 
whether they are on the network or attached only to local systems. SAP uses Service 
Access Control (SAC) commands to set up and manage services. 

Terminal and Modem Differences 

The SAP controls access to system and network resources. It provides a common 
interface for managing a range of services, including the ability to: 

■ Log in (either locally or remotely) 

■ Access printers across the network 

■ Access files across the network 

SAP provides two major commands: sacadm and pmadm. The sacadm command controls 
daemons called port monitors. The pmadm command controls the services associated with 
the port monitors. The SAP replaces / usr/etc /getty for controlling logins. 

Printing Differences 

The LP print service replaces the ipd daemon and ipr, ipq, iprm, and ipc commands. The 
services provided by the /etc/printcap file are handled by the terminfo database and by 
the files in the / etc / Ip directory. SunOS 4.x printing conunands are provided as part of 
the BSD compatibility package. However, the compatibihty package provides only 
SunOS 4.x command names, which are actually an interface to the underlying LP print 


services. 
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The LP print service provides additional functionality not available in SunOS 4.x systems. 
This functionality allows you to control forms, printwheels, and interface programs, and to 
set up network print services. 

Even though some SunOS 4.x printing commands are available, encourage users to learn 
the SunOS 5.x versions. Convert your own administration emironments as soon as 
possible because support for compatibility mode may not be available in future releases. 

Changes to the Solaris 2.6 printing software provide a better solution than the LP print 
software in previous Solaris releases. You can easily set up and manage print clients using 
the NIS or NIS+ name services to enable centralization of print administration for a 
network of systems and printers. New features include redesign of print packages, print 
protocol adapter, bundled SunSoft Print Client software, and network printer support. 


Naming Services 

A new naming service, NIS+, replaces NIS on previous SunOS releases. NIS+ supports 
the following combinations of systems: 

■ SunOS 5.x software installed on all servers and workstations 

■ SunOS 5 .a: software installed on one server, but combined with some SunOS 4.x 
servers 

■ SunOS 5.x software installed on some workstations, running with SunOS 4.x servers 

NIS+ information is stored in tables instead of in NIS maps. You use NIS+ shell 
commands to set up an NIS+ service. To administer the service, you can use either NIS+ 
shell commands or the Administration Tool’s Database Manager. 

NIS+ responds to requests from NIS. SunOS 5 .j: clients can run either NIS or NIS+. 


TCP/IP 



The user interface for TCP/IP is the same, but you administer NIS+ tables using Solstice 
AdminSuite. Starting with the Solaris 2.5 release, Admintool can be used only to 
administer local systems. 


UUCP 

The UNIX-to-UNIX Copy (UUCP) is the same as the HoneyDanBer UUCP available 
with SunOS 4.x systems. It uses the same set of configuration files, scripts, and 
commands, so any changes you made in SunOS 4.x files and scripts should work with 
this release. 


I 







Table A-7 describes new files and commands that were not part of the SunOS 4.x 
implementation. 


Table A-7 


New SunOS 5.x UUCP Files and Commands 


Command or File 

D. data files 
P. data files 


Function 

These data files are created when a UUCP command line specifies copying the source 
file to a spool directory. All data files have the format systmxxxxyyy. systm is the 
first five characters in the name of the destination system, xxxx is a four-digit job 
sequence number, and yyy distinguishes between several data files created for one job. 


/etc/uucp/Grades Maps text grade names to system names. 


/etc/uucp/Limits Specifies the number of concurrent UUCP sessions that can occur. Replaces 
Maxuuscheds and Maxuuxqts files in previous versions. 

/etc/uucp/Config Contains information to override tunable parameters in UUCP. The only tunable 

parameter currently available is Protocol, so system administrators normally will not 
have to modify this file. 


uuglist 


Sets service grade permissions available. 


UUCP includes a few additional features that can affect system administration: 

■ Checkpoint-restart facilities 

■ Job grades that control UUCP transmission 

■ Two new configuration files to limit the number of concurrent UUCP sessions that the 
system can run, and to override tunable UUCP parameters 


Document Tool Differences 

NOTE. SunOS 5.x systems provide a set of PostScript filters and device-independent 
fonts. However, some SunOS 4.x TranScriptfilters have SunOS 5.x equivalents, and oth¬ 
ers do not. In SunOS 5.x systems, there is no T^Xfilter, no pscat (C/A/T) filter, and no 
raster image filter. 

The SunOS 5.0 system provides device-independent troff, with these changes: 

■ SunOS 4.x troff input files work with SunOS 5.x troff. 

■ The troff default output goes to stdout instead of the printer. Therefore, you must 
specify a printer when you use troff formatting or scripts to print the output. 
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Security 

Security combines a number of features from SunOS 4.1 and AT&T SVR4 with 
functionality added specifically for the Solaris 1.x releases. Some of the SunOS 4.x 
security programs are packaged differently. 

The following sections describe major security differences and highlight how those 
changes may affect system administration procedures. The security features are: 

■ SunOS 4.x security features available with SunOS 5.a: software 

■ SunOS 5.x security features 

■ The Automated Security Enhancement Tool (ASET) 

■ Kerberos security 


SunOS 4.x Security 

Most of the security features from SunOS 4.x systems are available. These include: 

■ Internet security 

■ . rhosts and hosts.equiv files 

■ Secure RPC, NFS, and RES 

SunOS 5.x Local Security 

Security for local systems includes storing encrypted passwords in a separate file, 
controlling login defaults, and providing restricted shells. Equivalent NIS+ security 
controls networkwide access to systems. The following sections summarize security 
features under local system control. 

The /etc/passwd and /etc/shadow Files 

The SunOS 5.x password command stores encrypted versions of passwords in a separate 
file, /etc / shadow, and allows root access to the shadow file only. General access to the 
encrypted passwords is thus restricted. The /etc /shadow file also includes entries that 
force password aging for individual user login accounts. 

The /etc/default Files 

Several files that control default system access are stored in the /etc/default directory. 
These files limit access to specific systems on a network. Table A-8 summarizes the files 
in the /etc/default directory. 
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Table A-8 Files in the /ete/defautt Directory 

File Function 

/etc/default /login Controls system login policies, including root access. The default is to limit root logins 
to the console. 

/etc/default/passwd Controls default policy on password aging. 

/etc/default /su Controls what root (su) access to system will be logged and where it is displayed. 


Restricted Shells 

System administrators can use restricted versions of the Kom shell (rksh) and Bourne 
shell (rsh) to limit the operations allowed for a particular user account. Restricted shells 
do not allow these operations: 

■ Changing directories 

■ Setting the $path variable 

■ Specifying path or command names containing / 

■ Redirecting output 

Note that the restricted shell and the remote shell have the same command name, with 
different path names: 

Restricted shell / usr/lib/rsh 

Remote shell /usr/bin/rsh 

ASET Security 

T\\& Automated Security Enhancement Tool (ASET) is included with the Solaris 2.x 
system. It was available as an unbundled option with SunOS 4.x systems. ASET allows 
you to specify an overall system security level (low, medium, or high) and automatically 
maintain systems at those levels. It can be set up to run on a server and all of its clients or 
on individual clients. 

ASET performs these tasks: 

■ Verifies system file permissions 

■ Verifies system file contents 

■ Checks integrity of group file entries 

■ Checks system configuration files 

■ Checks environment files (. profile, . login, and. cshrc) 
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■ Verifies eeprom settings to restrict console login access 

■ Allows establishment of a firewall or gateway system 

Kerberos Security 

The Solaris 2.x system introduces support for Kerberos authentication for secure RPC. 
Kerberos source code and administrative utilities are available from Massachusetts 
Institute of Technology. 

Solaris 2.x Kerberos support includes: 

■ Client applications library that can use Kerberos 

■ Kerberos option to secure RPC 

■ NFS application with Kerberos 

■ Commands to administer user tickets on the client 

Everything else is available in the MIT Kerberos release. 

NOTE. Solaris 2.6 provides the ability to connect to the Kerberos functionality. How¬ 
ever, it does not provide the Kerberos package. You can ftp Kerberos 4 source from 
athena -dist. mit. edu using anonymous as a username and your e-mail address as a pass¬ 
word. The source is located in the pub/kerberos directory. 


Table of Command Equivalents 

Table A-9 lists SunOS 4.x commands and files in alphabetical order and describes the 
new SunOS 5 .a: conunand, equivalent, or unavailability. Commands that are not listed in 
this table are completely compatible with previous releases. 


Table A-9 

System Administration File and Command Equivalents 

SunOS 4.x 

SunOS 5.x 

Comments 

ac 

sar 

The System Accounting Resource package (SAR) provides most of 
the accounting functionality available in ac. 

add_services 

pkgadd 


analyze 

adb 

Use adb on core files to analyze crashes. 

arch 

uname -m 

SunOS 4.x shell scripts used the arch command to determine 
system architecture. Use uname -ra as a replacement in SunOS 5.x 
scripts. 





Table A-9 System Administration File and Command Equivalents (continued) 

SunOS 4.x SunOS 5.x Comments 

at, atq, atrm at, atq, atrm The at, atq, and at rtn commands behave slightly differently than 

they do in SunOS 4.x systems. Security for nonpriviieged users is 
more restricted on SunOS 5.xsystems. 

audit, audit_warn, Not available See your system vendor for Information on this product. 

auditd 

autdmount autotnount The auto.master and auto.home files are renamed auto„inaster 

and auto_home. The default home directory path is 
/export/home/pserna/ne. The -m option is not available. The 
SunOS 5.x automount program searches for Auto_master and 
Auto_home as the default. If these files are not found, it looks for 
Auto.master and Auto.home files. You do not need to rename these 
files on SunOS 4.x systems. 


bar 

Not available 

Use the tar command to replace bar for most uses. You can use 
cpio -H bar to restore existing SunOS 4.x bar backups. 

batch 

batch 

The c, s, and m options are not In the batch command. By default, 
the batch job queuenam is not specified. 

biff -y 

biff -n 

chmod o+x 
/dev/tty 
chmod o-x 
/dev/tty 

When users log on, start-up shell scripts often use the biff 
command to set default file protection for the user. Replace those 
commands to make SunOS 5.x scripts work correctly. 

/bin/mail 

mail 


biod 

Not available 


C2conv 

Not available 

See your system vendor for information on this product. 

C2unconv 

Not available 

See your systeSm vendor for information on this product. 

cc 

Not available 

The C compiler is available only as an unbundled product. 

change_login 

Not available 


check4 

Not available 


chgrp 

Changed 

The -f option to suppress error reporting is not available. 

chmod 

Changed 


chown 

Changed 

The default behavior of symbolic links is changed. SunOS 4.x 
chown changed ownership of the symbolic link. SunOS 5.x chown 
follows the link. To change the ownership of the link, use chown 
-h. SunOS 5.x chown does not allow the group ID of a file to be 
changed. 

client 

Not available 


colldef 

colltbl 


crash 

Changed 

The default file name in SunOS 5.x software is /kernel/genunix 
instead of/vmunix. 

date 

Changed 






295 



Table 

of Command Equivalents 

Table A-9 

System Administration File and Command Equivalents (continued) 

SunOS 4.x 

SunOS 5.x 

Comments 

dbxtool 

debugger 

See your system vendor for information on this product. 

dcheck 

Not available 


dd 

Changed 

The Sun OS 4.1 dd command uses 4-byte words. The SunOS 5.x dd 
command uses 2-byte words. 

devinfo 

Changed 


devnm 

Changed 

The name argument is required for SunOS 5.x devnm. The output 
format has also changed. 

df 

df -k 

Output of the df command Is changed. The SunOS 4.x df -t 
fstype command reSports on files of the specified type. The 

SunOS 5.xdf-t command prints full listings with totals. 

dkctl 

Not available 


dkinfo 

prtvtoc 


dorfs 

rfstart 



rfstop 


du 

du -k 

The SunOS 4.x version of du reports disk usage in kilobytes, but 
the SunOS 5.x du command reports disk usage in 512-byte blocks 
(by default). 

dump 

ufsdump 

The -a option dumps the archive header of each member of an 
archive. The -D option dumps debugging Information. The -v option 
dumps information in symbolic form. 

dumpfs 

Not available 


etherfind 

Not available 

Similar functionality is available in the SunOS 5.x snoop command. 

exportfs 

share 


extract_files 

Not available 


extract_patch 

Not available 


extract_unbundled pkgadd 


fastboot 

init 6 


fasthalt 

init 0 


file 

Changed 

The file command does not have the -L option. 

find 

Changed 

The find command does not have the -n cpio option. 

fmt_mail 

Not available 


fsck 

Changed 

fsck specifies most options after the file system type, fsck -m 


does a quick file system check. The -w option is not available. New 
options include -f, -v, and -o. 
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Table A~9 

System Administration File and Command Equivalents (continued) 

SunOS 4.x 

SunOS 5.x 

Comments 

fsirand 

Not available 


hostid 

sysdef -h 


hostname 

uname -n 


in it 

Changed 

See Chapter 1 for more information on init. 

installtxt 

msgfmt 


intr 

Not available 


iostat 

Changed 

The -X and -c options are added; -x to provide disk statistics, 
and -c to report the Stime the system spends in user mode, 
system mode, and idle. 

keyenvoy 

Not available 


Idconfig (wrong) 

Not available 


leave 

Not available 

Functionality in cron and at replace the leave command. 

lint 

Not available 

Available with unbundled C compiler for SunOS 5.x systems. 

load 



loadc 

pkgadd 

Provides part of the functionality of the SunOS 4.x load command. 

load_package 

Not available 


Ipc 

Ipsched 


Ipd 

Ipadmin 


Ipq 

Ipstat 


Ipr 

IP 


Iprm 

cancel 


Iptest 

Not available 


Is 

Changed 

Default output for the Is command is changed. The Is -1 
command displays both user and group ownership. 

mach 

uname -p 


makekey 

Not available 


man 

Changed 

The organization of man pages is changed. All system 
administration man pages are now located in section IM, The man 
command now allows you to set an environment variable to specify 
a default order of directories and sections for man to search. 

mkfs 

Changed 

mkfs supports different file system types. 

mknod 

Changed 

Users other than root can now create character and block special 
files. 
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Table A-9 

System Administration Fiie and Command Equivaients (continued) 

SunOS 4.x 

SunOS 5.x 

Comments 

modstat 

modinfo 


mount 

Changed 

Options must be specified after the file system is specified (unless 
the file system is in / etc/vf stab). 

mount_tfs 

mount -F fstype 

Options to the mount command (Instead of separate mount 
commands) are used to specify file system types. 

ncheck 

Changed 

Allows use of specific file system types. 

ndbootd 

Not available 

The -m option Is not available. The -1 option changes addr 
immediately. The variable addrS cannot be specified in 
hexadecimal format. 

nlsadmin 



nulladm 

Not available 


pac 

Not available 


passwd 

Changed 

The -F filename option is not available. The -f and -s options 
have different meanings. The -f option forces the user to change 
the password at the next login. The -s option displays the 
password attributes for the user’s login name. 

pax 

cpio 


paxcpio 

cpio 


portmap 

rpcbind 


praudit 

Not available 

Will be available when the unbundled C2 security product is 
released. 

printenv 

env 


ps 

Changed 

Many of the 4.x options to ps are not available or the meanings 
have changed. Instead of ps -aux, useps -el for SunOS 5.x 
systems. See the ps(l] manual page for more Information. 

pstat 

sar 


pstat -s 

swap -s 

Shows the total amount of swap space available on the system. 

rc 

Not available 

The organization of rc files is changed. They are now divided into 
subdirectories by run levels. 

rc.boot 

Not available 


rc.local 

Not available 


rdutnp 

ufsdump . 


reset -s 

Not available 


restore 

ufsrestore 
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Table A-9 

System Administration File and Command Equivalents (continued) 

SunOS 4.x 

SunOS 5.x 

Comments 

rniail 

Changed 

The rmail command in the SunOS 4.x system handles remote 
mail. The rmail command In the SunOS 5.x system is a link to 
mail and is used to read mail. 

rni_client 

Not available 

Functionality of admintool replaces this command. 

rni_services 

Not available 


rpc.etherd 

Not available 


rpc.lockd 

lockd 


rpc.mountd 

mountd 


rpc.rexd 

Not available 


rpc.rquotad 

Not available 


rpc.showfhd 

showfhd 


rpc.statd 

statd 


rpc.user_agentd 

Not available 


rpc.yppasswdd 

Not available 


rpc.ypupdated 

ypupdated 


rrestore 

ufsrestore 


rusage 

Not available 


rwall 

Changed 

The -f and -n optionsS are not available. 

setsid 

Not available 


shutdown 

Changed 

See Chapter 1 for more information on shutdown. 

startup 

Not available 


stty 

Changed 


suninstall 

Changed 

Although the command name is the same, the installation 
procedure is changed completely. 

swapon 

swap - a 

In general, options to the swap command replace functionality of 
individual swap-related commands, such as swapon, in SunOS 4.. 
systems. 

sys-config 

Not available 

Functionality of solstice replaces this command. 

tfsd 

Not available 


trpt 

Not available 


tset 

Changed 

The -S option is not available. 

ttysoftcar 

Not available 

- 


i 
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Table Ar-9 

System Administration File and Command Equivalents (continued) 

SunOS 4.x 

SunOS 5.x 

Comments 

tvconfig 

1 

Not available 


i tzsetup 

Not available 


i umount 

i 

Changed 

File-specific options may be required. 

1 uinount_tfs 

umount -F fstype 

unlink 

Changed 

Any user can unlink a directory. 

unload 

pkgrm 


1 

unset4 

Not available 


i update 

fsflush 


uptime 

Unchanged 

You can also use who ■ b to display the system boot time. 

! users 

! 

who -q 


uulog 

! 

i 

Changed 

The -u option, used to print information sorted by user, is not 
available. 

j uusend 

Not available 


1 vipw 

Not available 


1 vmstat 

Changed 

The -f option Is not available. 

vswap 

Not available 


! wall 

i 

Not available 


1 whereis 

Not available 


whoami 

1 

id 

The id command printsS the user name and user and group IDs, 
instead of just the user name. 

' ypbatchupd 

Not available 


i 

1 yppasswd 

1 

nispasswd 

The yppasswd command is still available to access the password 
information on NIS servers. The equivalent command for NIS-f 


i databases is nispasswd, and the equivalent command for systems 

I with no name service is passwd. 

I 


ypserv 


Not available 



archive A copy of files on secondary media, that have been removed from the system because they 
are no longer active. 

Auto_home database The database that you use to add home directories to the automounter. In 
SunOS 4.x releases, this database is a file named auto. home. 

automounter Software that automatically mounts a directory when a user changes into it and 
unmounts the directory when it is no longer in use. 
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backup schedule The schedule you establish for a site that determines when you run the 
ufsdump command on a regular basis at different levels to back up user files and essential file 
systems. 

bang An exclamation point (!) that acts as a single-character UNIX command or as a separator 
between the routes of a route-based e-mail address. 

boot block An 8-Kbyte disk block that contains information used during booting: Block 
numbers point to the location of the /boot program on that disk. The boot block directly follows the 
disk label. 

booting The process of powering up a system, testing to determine which attached hardware 
devices are running, and bringing the operating system kernel into memory and operation at the 
run level specified by the boot command. 

cache A small, fast memory area that holds the most active part of a larger and slower memory. 

CDE Common Desktop Environment. A windowing system based on the Motif graphical user 
interface. 

core file An image of the state of the software when it failed, used for troubleshooting. The core 
files can be created by any software, including the operating system kernel. 

crash See hang. 

crash dump A core file image of the operating system kernel that is saved in the swap partition 
when a system crashes. If crash dumps are enabled, the core image is written from the swap 
partition to a file. 

cylinder group One or more consecutive disk cylinders that include inode slots for files. 

cylinder group map A bitmap in a UFS file system that stores information about block use and 
availability within each cylinder. The cylinder group replaces the traditional free list. 

daemon A type of program that, once activated, starts itself and carries out a specific task 
without any need for user input. Daemons are typically used to handle jobs that have been queued 
such as printing, mail, and communication. 

disc An optical disc or a CD-ROM. 

disk A hard-disk storage device. 

diskette A nonvolatile storage medium used to store and access data magnetically. SunOS 5.x: 
system software supports 3.5-inch double-sided high-density (DS, HD) diskettes. 

diskless client A system with no local disk drive that relies on an NFS server for the 
operating system, swap space, file storage, and other basic services. 

disk quotas A mechanism for controlling how much of a file system’s resources any individual 
user can access. Disk quotas are optional and must be configured and administered to be used. 

domain A directory structure for e-mail addressing and network address naming. Within the 
United States, top-level domains include com for commercial organizations; edu for educational 






organizations; gov for governments!; mil for the military; net for networking organizations; and 
org for other organizations. Outside the United States, top-level domains designate the country. 
Subdomains designate the organization and the individual system. 

domain addressing Using a domain address to specify the destination of an e-mail message. 

DS, HD Double-sided, high-density. The type of 3.5-inch diskettes supported by the SunOS 5 .a; 
system software. 

dump The process of copying directories onto media (usually tape) for off-line storage by using 
the uf sdump command. The uf sdump command is an enhanced version of the SunOS 4.x dump 
command. 

e-mali Electronic mail. A set of programs that transmit mail messages from one system to 
another, usually over communications lines. 

environment variable A system- or user-defined variable that provides information about the 
operating environment to the shell. 

file system A hierarchical arrangement of directories and files. 

floppy diskette See diskette, 
free list See cylinder group map. 

full backup A complete, level 0 backup of a file system done by using the uf sdump command. 

fully qualified domain name A domain name that contains all the elements needed to specify 
where an e-mail message should be delivered. See also domain. 

gateway A system that handles e-mail traffic between different communications networks. 

GID The group identification number used by the system to control access to accounts owned by 
other users. 

Group database The database that you use to create new group accounts or to modify existing 
group accounts. 

hang A condition in which a system does not respond to input from the keyboard or mouse. 

home directory The part of the file system that is allocated to an individual user for private 
files. 

Hosts database The database you use to control network security. 

incremental backup A partial backup of a file system that is performed by using the uf sdump 
command that includes only those files in the specified file system that have changed since a 
previous backup at a lower level. 

initialization files The dot files (files prefixed with .) in a user’s home directory that set the 
path, environment variables, windowing environment, and other characteristics to get users up and 
functioning. 
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init state One of the seven initialization states, or run levels, a system can be running in. A 
system can mn in only one init state at a time. 

inode An entry in a predesignated area of a disk that describes where a file is located on that 
disk, the size of the file, when it was last used, and other identification information. 

input variables The environment variables that CDE’s dtsearchpath reads. 

IP address A unique Internet protocol number that identifies each system in a network. 

kernel The master program set of SunOS software that manages all the physical resources of the 
computer, including file system management, virtual memory, reading and writing files to disks and 
tapes, scheduling of processes, printing, and communicating over a network. 

login name The name assigned to an individual user that controls access to a system. 

manual pages On-line technical references for each SunOS 5.x command. 

metacharacter A symbol used in file names and extensions to represent another character or 
string of characters. An asterisk (*) matches any number of characters. A question mark (?) 
matches a single character. 

monitor The program in the PROM that provides a limited set of commands that can be used 
before the kernel is available. See PROM. 

mount point A directory in the file system hierarchy where another file system is attached to 
the hierarchy. 

NFS The default SunOS 5.x distributed file system that provides file sharing among systems. 

NFS servers can also provide kernels and swap files to diskless clients. 

NIS The SunOS 4.x network information service. 

NIS+ The SunOS 5.x network information service. 

Oi^nWindows A windowing system based on the OPEN LOOK graphical user interface. 

parse To resolve a string of characters or a series of words into component parts to determine 
their collective meaning. Virtually every program that accepts command input must do some sort of 
parsing before the commands can be acted on. For example, the sendmail program divides an 
e-mail address into its component parts to decide where to send the message. 

partition A discrete portion of a disk, configured using the format program. Also referred to as 
slice. 

Passwd database The database that you use to add, modify, or delete user accounts. 

path The list of directories that are searched to find an executable command. 

path name A list of directory names, separated with slashes (/), that specifies the location of a 
particular file. 

port A physical connection between a peripheral device (such as a terminal, printer, or modem) 
and the device controller. 
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port monitor A program that continuously watches for requests to log in or requests to access 
printers or files. The ttymon and listen port monitors are part of the Service Access Facility. 

power cycling Turning the power to a system off and then on again. 

preen To run f sck with the -o p option, which automatically fixes any basic file system 
inconsistencies normally found when a system halts abruptly without trying to repair more serious 
errors. 

process A program in operation. 

PROM Programmable read-only memory. A chip containing permanent, nonvolatile memory and 
a limited set of commands used to test the system and start the boot process. 

run level See init state. 

runaway process A process that progressively uses more and more CPU time. 

server A system that provides network service such as disk storage and file transfer, or a 
program that provides such a service. 

Service Access Facility (SAF) The part of the system software that is used to register and 
monitor port activity for modems, terminals, and printers. SAF replaces / etc/getty as a way to 
control logins. 

shell The command interpreter for a user, specified in the Passwd database. The SunOS 5.^: 
system software supports the Bourne (default), C, and Korn shells. 

slice An alternative name for a partition. See also partition. 

spooling directory A directory where files are stored until they are processed. 

spooling space The amount of space that is allocated on a print server for storing requests in 
the printer queue. 

Stand'Olone system A system that has a local disk and can boot without relying on a server. 

state fiag A flag in the superblock that the f sck file system check program updates to record the 
condition of a file system. If a file system state flag is clean, the f sck program is not run on that file 
system. 

superuser A user who is granted special privileges if the correct password is supplied when 
logging in as root or using the su command. For example, only the superuser can edit major 
administrative files in the /etc directory. 

swap file A disk partition or file used to temporarily hold the contents of a memory area until it 
can be loaded back into memory. 

symbolic link A file that contains a pointer to the name of another file. 

system A computer with a keyboard and terminal. A system can have either local or remote 
disks, and may have additional peripheral devices such as CD-ROM players, tape drives, diskette 
drives, and printers. 



UFS UNIX file system. The default disk-based file system for the SunOS 5.x operating system. 

UID User Identification. The user identification number assigned to each login name. UID 
numbers are used by the system to identify, by number, the owners of files and directories. 

user account An account set up for an individual user in the Passwd database that specifies the 
user’s login name, UID, GID, login directory, and login shell. 

user mask The setting that controls default file permissions that are assigned when a file or 
directory is created. The umask command controls the user mask settings. 

virtual memory A memory management technique that is used by the operating system for 
programs that require more space in memory than can be allotted to them. The kernel moves only 
pages of the program currently needed into memory; unneeded pages remain on the disk. 

zombie A process that has terminated but remains in the process table because its parent process 
has not sent the proper exit code. Zombie processes do not consume any system resources and are 
removed from the process table when a system is rebooted. 
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Symbols 

/ (kernel directory), 284 
I operator, 60 
1/2-inch front-loaded reel 
drives, 69 

3.5-inch diskettes, 94 

A_ 

aborting booting, 17 
absolute path names (files), 75 
ac command, 293 
accept /reject command, 187 
accounts, 305 
adding, 212 

Admintool, 227-230 
administering with 
Admintool, 230-232 
deleting with Admintool, 
232-233 

disabling with Admintool, 
233 

groups, setting up, 234 
mail, configuring, 224 
modifying, 230 
setting up, 219-224 
acronyms (tape drive 
controllers), 67 
adb command, 293 
Add command (Edit menu), 118 
Add Group window, 238 
add_services command, 293 


administering 
disks, 99 

NIS-(- databases, 166 
users, 209 

Admintool, 230-232 
administration tools, 36 
Admintool, 49,178, 300 
bidirectional modems, 
configuring, 120 
groups 

creating, 237-238 
deleting, 239 
modifying, 239 
GUI (graphical user 
interface), 112 
local printers, configuring, 
118,193-196 
starting, 49,112 
users 

adding, 227-230 
administering, 230-232 
deleting, 232-233 
disabling, 233 
Users window, 227 
admintool& command, 243 
alias command, 252 
aliases 

Kom shell, creating, 252 
local mail, creating, 266 
alphanumeric terminals, 
administration (SAP), 115 
Alternative Multiuser State (run 
level 4), 12 

analyze command, 293 


appending files 

diskettes, 96 
tapes, 72 

applications, workman, 92 
arch command, 293 
archiving files, 106, 300 
ASET (Automated Security 
Enhancement Tool), 292 
at command, 294 
AT&T Bell Laboratories 
Bourne Shell, 245 
Korn shell, 249 
AT&T System V, 3 
Atomic style command, 192 
atq command, 294 
atrm command, 294 
audit command, 294 
audit_wam command, 294 
auditd command, 294 
Auto_home database, 300 
AutoFS, 144 

automount command, 294 
automounter, 300 
automounting directories, 144 
awk command, 210 
awk programming language, 
210 

■B_ 

Backspace key (C shell), setting, 
248 

backup tapes, choosing, 151 
backups, 147-157 
full backups, 302 
incremental, 302 
schedules, 301 


307 








bangs, 301 

bar command, 97, 294 
batch command, 294 
Berkeley UNIX, 3 
bidirectional modems, 
configuring with Admintool, 
120 

biod command, 294 
blocks, repairing, 108 
boot blocks, 301 
boot messages, viewing, 15 
boot server, 169 
booting, 14, 301 
aborting, 17 
interactively, 15 
single-user state, 14 
systems, 14 
Bourne, 243, 245 

environment variables 
defining, 46, 245 
PATH, 48 

initialization file, 245 
search paths, setting, 270 
Bourne, Steve, 245 
Browse menu commands 
Groups, 237 
Printers, 194 
Serial Ports, 113 
Users, 228 

BSD, see Berkeley UNIX 
bus controllers (disks), 100 

c_ 

C shell, 243-245 

Backspace key, setting, 
248 

command history, 245 


environment variables 
defining, 246 
setting paths, 48 
history, 246 
editing, 248 
setting, 246 
rehash command, 248 
search paths, setting, 270 
variables, defining, 46 
C2conv command, 294 
C2unconv command, 294 
CacheFS, 128 
creating, 155 
caches, 301 

creating, 156 
maintaining, 158 
CALENDAR environment 
variable, 45 

cancelling print requests, 206 
cat command, 56 
catman command, 61 
cc command, 294 
cd command, 197 
CDE (Common Desktop 
Environment), 301 
diskettes 

displaying contents, 88 
formatting, 90 
input variables, 46 
search path variables, 46 
variables, 46 

CDPATH environment van- . 

able, 45 

CD-ROMs 

files, accessing shared, 84 
mounting, 77 


remote, sharing files, 83 
volume management, 77, 
82 

mount points, 81 
changejogin command, 294 
check4 command, 294 
chgrp command, 218, 294 
chmod command, 272, 294 
chown command, 218, 272, 
294 

classes (processes) 
changing, 34 
displaying informa¬ 
tion, 31 

clear command, 244 
client command, 294 
client failover (NFS), 126 
clients, print, 193 
clri command, 135 
colldef command, 294 
colltbl command, 294 
command history (C shell), 245 
command line 

commands, combining, 59 
diskettes, formatting, 85 
shells, changing, 244 
Command Tool windows, 
opening, 16 

commands, 26, 53, 73, 135, 
210, 297-299 
ac, 293 

accept/reject, 187 
adb, 293 

add_services, 293 
admintool&, 243 
alias, 252 
analyze, 293 
arch, 293 
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at, 294 

atomic style, 192 
atq, 294 
atrm, 294 
audit, 294 
audit_wam, 294 
auditid, 294 
automount, 294 
bar, 97, 294 
batch, 294 
biod, 294 
Browse menu 
Groups, 237 
Printers, 194 
Serial Ports, 113 
Users, 228 
C2conv, 294 
C2unconv, 294 
cat, 56 
catman, 61 

cc, 294 

cd, 197 

changejogin, 294 
check4, 294 
chgrp, 218, 294 
chmod, 272, 294 
chown, 218, 272, 294 
clear, 244 
client, 294 
clri, 135 
colldef, 294 
combining, 59 
1 operator, 60 
command line, 59 
context-based style, 192 
cp, 57 
cpio, 65, 90 
crash, 294 


csh, 244 
date, 263, 294 
dbxtool, 295 
dcheck, 295 
dd, 106, 295 
debugger, 295 
devinfo, 295 
devnm, 138, 295 
df, 135, 295 
dispadmin, 19 
dkctl, 295 
dkinfo, 295 
dorfs, 295 
du, 104, 295 
dump, 295 
dumpfs, 295 
echo $PATH, 270 
Edit menu 
Add, 118 
Delete, 239 
Modify, 231 
egrep, 39 
eject, 94 

equivalents, 293-299 
etherfmd, 295 
executing, 271 
exit, 244 
exportfs, 295 
extract_files, 295 
extract_patch, 295 
extract_unbundled, 295 
fastboot, 295 
fdformat, 94 
ff, 135 
file, 295 
find, 38,295 
finger, 53 
fmt_mail, 295 


fsck. 111, 135, 146, 295 

fsdb, 135 
fsirand, 296 
fstyp, 135, 138 
ftp, 163-164 
grep, 210 
groupadd, 210 
groupmod, 211 
halt, 14 
hostid, 296 
hostname, 296 
idconfig, 296 
init, 296 
installtxt, 296 
intr, 296 
iostat, 296 
keyenvoy, 296 
kill, 25 

Korn shell, 250-251 
displaying, 254 
editing, 253 
ksh,244 
labelit, 135 
leave, 296 
lint, 296 
load, 296 

load_package, 296 
loadc, 296 
Ipadmin, 187, 197 

l pc, 296 

l pd, 296 
Ipfilter, 187 
Ipforms, 187 
Ipmove, 187 

l pq, 296 

l pr, 296 
Iprm, 296 
Ipshut, 187 
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Ipstat, 198, 202, 205 

pfiles, 20, 26 

rfstart, 295 

Ipsystem, 187 

pfiags, 20, 26 

rfstop, 295 

Iptest, 296 

ping, 162 

rlogin, 162-163 

Ipusers, 187 

pkgadd, 293-295 

rm_client, 298 

Is, 296 

pkgrm, 241 

rpcinfo, 162 

mach, 296 

pldd, 20, 26 

rup, 161 

mail, 294 

pmadm, 121 

rusage, 298 

make, 209 

pmap, 20, 26 

rusers -1, 53-54 

makekey, 296 

portmap, 297 

rwall, 298 

man, 61, 296 

POSIX style, 192 

sacadm, 121 

manual pages, 61 

praudit, 297 

sacadmin, 288 

mkfile, 264 

printenv, 297 

sar, 293 

mkfs, 135, 296 

printing, 200 

set history, 246 

mknod, 296 

priocntl, 19, 30 

setid, 298 

modstat, 297 

prtconf, 258 

sh, 244 

mount, 110, 126, 135, 297 

prtvtoc, 105, 295 

share, 295 

mount_tfs, 297 

prun, 20, 26 

shells, 243 

mountall, 135, 218 

ps, 19, 21, 297 

shutdown, 10,13,18,278, 

mv, 57 

psig, 20, 26 

298 

ncheck, 135, 297 

pstack, 20 

sort, 210 

ndbootd, 297 

pstat, 297 

startup, 298 

newfs, 110 

pstop, 20, 26 

status, 70 

nice, 19, 35 

ptime, 20,26 

stdout, 290 

nisbackup, 149 

ptree, 20, 26 

stty, 298 

nisclient, 209 

pwait, 20, 26 

stty erase, 248 

nismatch, 210 

pwdx, 20, 26 

su (switch user), 5 

nispasswd, 225 

r mail, 298 

suninstall, 298 

nisrestore, 149 

rc, 297 

swap, 264 

nistbladm, 209 

rc.boot, 297 

swapon, 298 

nlsadmin, 297 

rc.local, 297 

sys-config, 298 

nulladmin, 297 

rep, 163 

sysdef-h, 257 

output, redirecting, 60 

rdump, 297 

tar, 70-71, 90, 95 

pac, 297 

reboot, 14 

telinit^init, 14 

partition, 108 

rehash, 248 

tfsd, 298 

passwd, 210 

reset -s, 297 

tip, 122 

pax, 76, 297 

restore, 297 

touch, 57 

paxcpio, 297 

retension, 70 

troff, 290 

pcred, 20, 26 

rewind, 70 

trpt, 298 
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tset, 298 
ttysoftciU", 298 
tzsetup, 299 
ufsdump, 148, 295 
ufsrestore, 110,149 
umask, 222 
umount, 111, 135,299 
umount._tfs, 299 
umountall, 135 
uname, 293 
uname -m, 257 
uname -r, 257. 
unload, 299 
unset4, 299 
update, 299 
uptime, 262,299 
useradd, 209 
userdel, 210 
usermod, 210 
users, 299 

/usr/proc/bin directory, 26 

uulog, 299 

uusend, 299 

vi, 58-59 

vipw, 299 

vmstat, 299 

volcheck, 86 

wall, 299 

whatis, 61 

whereis, 299 

which, 271 

who, 53 

who -b, 262 

whoami, 299 

whodo, 53-54 

ypbatchchupd, 299 

yppasswd, 299 

ypserv, 299 


Common Desktop 
Environment (CDE), see CDE 
configuration files, LP print 
service, 185 
configuring 

bidirectional modems with 
Admintool, 120 
disk slices, 102 
Group databases, 235 
local printers with Admin¬ 
tool, 118, 193-196 
mail accounts, 224 
PostScript print clients, 
199 

print servers, 196-197 
print services, 193 
printers 
users, 224 
SunOS 5.x, 277 
swap space, 264 
system environments, 43 
Context-based style command, 
192 

controllers (tape drives), 
abbreviations, 67 
converting systems (Host 
Manager), 168 
copying 

data from disks, 106 
directories (tapes), 70, 74 
files, 57 

multiple diskettes, 97 
tapes, 70,76 
core files, 301 
cp command, 57 
cpio command, 65, 73, 90 
crash command, 294 
crash dumps, 301 


csh command, 244 

current search path, displaying, 

270 

cylinder group maps, 301 
cylinder groups, 301 

P__ 

daemons, 12, 301 

LP print service, 186 
Database Manager (Solstice 
AdminSuite), 51 
databases 

Auto_home, 300 
Group, setting up, 235 
NIS+, 166 
Passwd, 303 
date and time (systems), 
determining/setting, 263 
date command, 263,294 
dbxtool command, 295 
dcheck command, 295 
dd command, 106, 295 
debugger command, 295 
default printers, printing to, 
200 

defining 

environment variables 
Bourne, 245 
C shell, 246 
groups, 234 
installation files, 219 
LP print services, 186 
variables, 46 

Delete command (Edit menu), 
239 

deleting groups, 239 
density (tape drives), 
specifying, 66-67 
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DESKSET environment 
variable, 45 
/dev directory, 285 
device names 

diskette drives, 94 
SunOS 5.x conventions, 
287 

/devices directory, 284 
devinfo command, 295 
devnm command, 138, 295 
df command, 135,295 
DFS, 283 

direct controllers (disks), 101 
directories, 36 

automounting, 144 
copying tapes, 74 
home directories, 215-218 
LP print service, 183 
spooling directories, 
190 

relieving tapes, 72 
SunOS 5.x changes, 283 
disabling volume management, 

93 

disk quotas, 301 
disk space, displaying, 62 
disk-based file systems, 126 
diskette drives, device names, 

94 

diskettes, 94, 301 

displaying contents, 88 
files 

appending, 96 
copying to multiple, 97 
listing, 95 
retrieving, 96 


formatting 

CDE File Manager, 90 
command line, 85 
File Manager, 86 
ufs, 94 
PCFS, 98 
mounting, 99 
reformatting, 94 
removing, 94 
UFS files, copying to, 95 
volume management, 77, 
85 

diskless clients, 301 
disks, 301 

administering, 99 
bus controllers, 100 
copying data from, 106 
direct controllers, 101 
information 
checking, 105 
finding, 62 

naming conventions, 99 
reformatting, 108 
repairing, 106 
blocks, 108 
replacing, 108 
slices 

choosing, 103 
configuring, 102 
file systems, 100 
x86, 103 

dispadmin command, 19 
displaying, 31, 204 

current search paths, 270 
disk space, 62 
diskette contents, 88 
environment variable 
settings, 47 


file information, 37 
files, 40 

host ID numbers, 257 
Kom shell commands, 254 
manual pages, 61 
printer status, 202, 205 
process class information, 
31 

process global priorities, 

31 

process information, 27-30 
system configurations, 258 
system environments, 43 
system-specific 
information, 257 
tape drive status, 70 
dkctl command, 295 
dkinfo command, 295 
domain addressing, 302 
domains, 301 

fully qualified domain 
name, 302 
dorfs command, 295 
DOS diskettes, 98 
DS (double-sided) diskettes, 94 
du (disk use) command, 104, 
295 

dump command, 295 
dumpfs command, 295 
dumps, 302 

E_ 

echo $PATH command, 270 
Edit menu commands 
Add, 118 
Delete, 239 
Modify, 231 
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editing 

C shell history, 248 
commands, Kom shell, 

253 

files, 56 

egrep command, 39 
eject command, 94 
e-mail, 302 

accounts, configuring, 224 
messages, sending, 10 
environment variables, 43-45, 
302 

Bourne, defining, 46, 245 
C shell, defining, 246 
defining, 46 
PATH, 48 

settings, displaying, 47 
environments 

information, finding, 55 
system, displaying/setting, 
43 

users, defining, 219-224 
/etc directory, 285 
/etc/default directory, 291 
/etc/inittab file, 278 
/etc/mail/aliases file, 266 
/etc/passwd file, editing, 212 
/etc/shadow file, 291 
/etc/TIMEZONE file, 263 
etherfind command, 295 
execute permissions, granting, 
272 

execute-only permissions, 273 
executing commands, 271 
exit command, 244 
exiting shells, 244 
exportfs command, 295 
extract_files command, 295 


extract_patch command, 295 
extract_unbundled command, 
295 

F_ 

fastboot command, 295 

fdformat command, 94 

PDFS (file descriptors), 130 

ff command, 135 

FIFOS (first-in first-out), 130 

file command, 295 

File Manager, formatting 

diskettes, 86 

File Manager CD-ROM 

window, 83 

file systems, 125, 302 

administrative commands, 
134 

availability, 138 
backing up, 147-157 
CacheFS, 128 
creating, 155 

commands, manual pages, 
136 

data consistency, 
checking, 146 
default, SunOS 5.x, 
130-131 
DFS, 283 
disks, slices, 100 
PDFS, 130 
FIFOS, 130 
HSFS, 127 

interactively checking, 

147 

local, determining, 63 
LOFS, 128 

mounting, 63,139-143 


NAMEFS, 130 
navigating, 36 
NFS, 127, 283 
determining, 63 
PCFS, 127 
PROFS, 129 
remaking, 110 
restoring, 147-157 
RFS, 127, 283 
S5FS, 127 
SPECFS, 130 
SunOS 5.x, 283 
SWAPFS, 130 
TMPFS, 128 
types, 126 

determining, 136-137 
UFS, 126 

unmounting, 140-143 
VFS, 125 

virtual file system table, 
131 

files 

absolute path names, 75 
appending on diskettes, 96 
archiving, 106 
CD-ROMs, accessing 
shared, 84 
copying, 57 

multiple diskettes, 97 
tapes, 70, 74, 76 
creating, 56 
displaying, 37, 40 
editing, 56 
finding, 37 

information, 37, 39 
types, 38 
group ownership, 
changing, 43 
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i 


I 


initialization files 
Bourne, 245 
C shell, 245 
defining, 219 
Korn shell, 249 
large files, handling, 126 
listing 

diskettes, 95 
tapes, 71 

naming with metacharac¬ 
ters, 72 

ownership, changing, 42, 
272 

permissions, changing, 42, 
272 

renaming, 57 
retrieving 
diskettes, 96 
tapes, 72, 75-76 
sharing 

remote CD-ROM 
drives, 83 
servers, 145 
subsets, retrieving from 
tapes, 75 

text strings, searches, 39 
transferring, systems, 163 
UFS, copying to diskettes, 
95 

viewing, beginning/end, 
41 

volume management, 
78-81 

filtering print files (LP print 

service), 181 

find command, 38, 295 


finding 

disk information, 62 
environment information, 
55 

files, 37 

information, 37, 39 
text strings, 39 
types, 38 
GID settings, 55 
manual pages, section 
numbers, 61 

mounted file systems, 63, 
140-143 

UID settings, 55 
users, information, 53 
finger command, 53 
fmt_mail command, 295 
formatting diskettes 

CDE FBe Manger, 90 
command line, 85 
File Manager, 86 
reformatting, 94 
ufs, 94 

forms, tracking with LP print 
service, 182 

fsckcommand. 111, 135,146, 
295 

fsdb command, 135 
fsirand command, 296 
fstyp command, 135,138 
ftp command, 163-164 
full backups, 302 
fully qualified domain names, 
302 


G_ 

gateways, 302 
GIDs (group IDs), 302 
large, 213 
settings, finding, 55 
global priorities, displaying 
processes, 31 

grace periods for shutdowns, 
changing, 18 
grep command, 210 
Group database, 302 
fields, setting up, 235 
group IDs, 274 
Group ID field, 236 
Group Manager (Solstice 
AdminSuite), 50 
Group Name field, 236 
groupadd command, 210 
groupmod command, 211 
groups 

creating, 237-238 
defining, 234 
deleting, 239 
modifying, 239 
ownership, changing, 43, 
274 

setting up, 234 
Groups command (Browse 
menu), 237 

H _ 

halt command, 14 
handling, 126 
hangs, 302 
hardware 

adding, 16 
determining, 257 
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Hayes Smartmodem 2400,122 
HD (high-density) diskettes, 94 
helical scan drives, 69 
help, manual pages, 61 
history 

C shell, 246 
editing, 248 
setting, 246 

Kom shell, setting, 253 
history environment variable, 
45 

history logs, LP print service, 
188 

home directories, 302 
creating, 215-218 
NFS-mounting, 218 
HOME environment variable, 
43 

HoneyDanBer UUCP, 289 
Host Manager, 50, 167 

multihoned hosts, adding, 
170 

OS services, adding/ 
removing, 168 
remote installation 
services, establishing, 169 
restrictions, 170 
root passwords, setting, 
169 

scripts, enabling, 169 
system types, updating, 
168 

systems, converting, 168 
tasks, queueing, 169 
hostid command, 296 
hostname command, 296 
hosts, displaying ID numbers, 
257 


Hosts database, 302 
HSFS (High Sierra FS), 127 
HZ environment variable, 45 

I_ 

ID numbers of hosts, 
displaying, 257 
incremental backups, 150, 302 
init 0 command, 295 
init 6 command, 295 
init command, 296 
init states, 10, 303 
choosing, 10 
run levels, changing, 12 
initialization files, 302 
Bourne shell, 245 
C shell, 245 
defining, 219 
Kom shell, 249 
in-line editor (Kom shell), 253 
inodes, 303 
input variables, 303 
CDE, 46 

install servers, 169 
installing SunOS 5.x, 277 
installtxt command, 296 
Interactive Reboot State (run 
level 5), 12 

interactively booting, 15 
interactively checking file sys¬ 
tems, 147 

internal files, LP print services, 
186 

intr command, 296 
iostat command, 296 
IP addresses, 303 


J-K_ 

Joy, Bill (C shell), 245 

Kerberos authentication, 293 
kernels, 303 

keyenvoy command, 296 
kill command, 25 
killing processes, 25 
Kom shell, 243 

aliases, creating, 252 
commands, 250-251 
displaying, 254 
editing, 253 
environment variables, 
PATHi 48 
history, setting, 253 
initialization files, 249 
search paths, setting, 270 
variables, defining, 46 
Kom, David (Kom shell), 249 
ksh command, 244 

L_ 

labelit command, 135 
LANG environment variable, 
44, 223 

large files, 126 

large GIDs, 213 

large UIDs, 213 

LC environment variable, 44, 

223 

Idconfig command, 296 
leave command, 296 
lint command, 296 
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listing 

files 

diskettes, 95 
tapes, 71 

table of contents, 74 
load averages (remote sys¬ 
tems), checking, 161 
load command, 296 
load_ package command, 296 
loadc command, 296 
local file systems, determining, 
63 

local mail aliases, creating, 266 
local printers, configuring with 
Admintool, 118,193-196 
local security (SunOS 5.x), 291 
LOFS (Loopback File System), 
128 

log files, LP print service, 187 
logical unit numbers (tape 
drives), 66 
login names, 303 
LOGNAME environment 
variable, 44 
logons 

remote systems, 163 
root, 6 

system-specific messages, 
displaying, 7 
users, determining, 53 
LP print service, 179 

commands, 178,184, 187 
configuration files, 185 
daemons, 186 
files, administering, 
180-181 

forms, tracking, 182 
internal files, 186 


jobs, status tracking, 182 
log files, 187 
print files, filtering, 181 
printer interface program, 
182 

printers, definitions, 186 
printwheels, tracking, 183 
problem alerts, receiving, 
183 

request logs, codes, 189 
requests, scheduling, 
180-181 

spooling directories, 190 
structure, 183 

Ipadmin command, 187, 197 
Ipc command, 296 
Ipd command, 296 
LPDEST environment 
variable, 45 
Ipfilter command, 187 
Ipforms command, 187 
Ipmove command, 187 
IpNet daemon (network print 
requests), 181 
Ipq command, 296 
Ipr command, 296 
Iprm command, 296 
Ipshut command, 187 
Ipstat command, 198, 202, 205 
Ipsystem command, 187 
Iptest command, 296 
Ipusers command, 187 
Is command, 296 

IVI_ 

mach command, 296 
magnetic tapes, see tapes 


mail, creating local mail 
aliases, 266 
mail command, 294 
MAIL environment variable, 

45 

make command, 209 
makekey command, 296 
man command, 61, 296 
MANPATH environment vari¬ 
able, 45 

MANSECTS environment 

variable, 45 

manual pages, 61, 303 

commands, file systems, 
136 

displaying, 61 
passwords, 225 
section pages, finding, 61 
messages 

boot messages, viewing, 

15 

messages of the day, 
creating, 7 
sending, 8 
e-mail, 10 
universally, 9 
system-specific, 
displaying at login, 7 
metacharacters, 303 
file names, 72 
mkfile command, 264 
mkfs command, 135, 296 
mknod command, 296 
modems, 122 

administration (SAP), 115 
bidirectional modems, 
configuring, 120 
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Hayes Smartmodem 2400, 
122 

naming conventions, 288 
Modify command (Edit menu), 
231 

Modify User window, 231 
modstat command, 297 
monitor, 303 
monitoring processes, 19 
mount command, 110,126, 

135,297 

mount points, 303 

CD-ROMs, volume 
management, 81 
creating, 156 
mount_tfs conmiand, 297 
mountall command, 135, 218 
mounted file systems, finding, 
63, 140-143 
mounting 

CD-ROMs, 77 
directories, automounting, 
144 

file systems, 139-143 
home directories, 
NFS-mounting, 218 
PCFS diskettes, 99 
multihomed host aliases, 
adding with Host Manager, 170 
multiple copies, printing, 201 
multiuser state (mn level 2), 12 
booting, 14 
multiuser systems 
rebooting, 18 
shutting down, 17-18 
mv command, 57 
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N_ 

NAMEFS, 130 
naming conventions 
devices, 287 
disks, 99 

files, metacharacters, 72 
tape drives, 66 
naming services, 289 
ncheck command, 135, 297 
ndbootd command, 297 
Network Information Service 
Plus, see NIS+ 

network printers, support, 177 
network-based file systems, 
127 

networks, sending messages, 9 
newfs command, 110 
NFS, 127, 283, 303 
client failover, 126 
determining, 63 
WebNFS, 126 
nice command, 19, 35 
NIS, 303 

NIS+ (Network Information 
Service Plus), 161, 289, 303 
databases, administering, 
166 

Host Manager, see Host 
Manager 
security, 173 
tables, 170,172 
nisbackup command, 149 
nisclient command, 209 
nismatch command, 210 
nispasswd command, 225 
nisrestore command, 149 
nistbladm command, 209 
nlsadmin command, 297 


no-rewind option (tape drives), 
67 

notifications (printing), 201 
nulladm conunand, 297 

0 _ 

opening Command Tool 
windows, 16 
OpenWindows, 303 
OPENWINHOME 
environment variable, 45 
operators, redirecting output, 
60 

/opt directory, 284 
options (Kom shell), 250 
OS release level, determining, 
257 

OS services, adding/removing 
with Host Manager, 168 
ownership 

changing, 272 
files, 42 
groups, 274 
troubleshooting, 271 

P_ 

pac command, 297 

parsees, 303 

partition command, 108 

partitions, 303 

passwd command, 210, 297 

Passwd database, 303 

passwords 

creating, 225-227 
manual pages, 225 
root, 5 

setting, 169 
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PATH environment variable, 
44, 48 

path names, 303 
paths, 303 

pax (portable archive inter¬ 
change) command, 76,297 
paxcpio command, 297 
PCFS, 127 

diskettes, 98-99 
pcred command, 20,26 
permissions 

changing, 42, 272 
troubleshooting, 271 
pfiles command, 20, 26 
pflags command, 20, 26 
ping command, 162 
pkgadd conunand, 293-295 
pkgrm command, 241 
pldd command, 20, 26 
pmadm command, 121 
pmap command, 20, 26 
port monitors, 114,288, 304 
portmap command, 297 
ports, 303 

printer, monitoring, 115 
POSIX style command, 192 
PostScript print clients, 
configuring, 199 
power cycling, 304 
power-down state (run level 0), 
11 

praudit command, 297 
preening, 304 

print clients, 177-178, 191-193 
configuration resources, 
192 

PostScript, configuring, 
199 


print requests, submitting, 
192 

processes, 192 
print files, filtering (LP print 
service), 181 
Print Manager, 178 
print protocol adapter, 176 
print requests 

scheduling with LP print 
service, 180-181 
submitting from print 
client, 192 
print servers, 193 

configuring, 196-197 
printenv command, 297 
printer interface program, LP 
print service, 182 
Printer Manager (Solstice 
AdminSuite), 51 
printer ports, monitoring, 115 
printer status, 204 
printers 

availability, determining, 
202 

characteristics, 
displaying, 205 
configuring with 
Admintool, 118 
default, printing to, 200 
definitions, LP print 
service, 186 

local printers, configuring, 

193-196 

managing, 178 

naming conventions, 288 

network printers, support, 

177 

printing to by name, 201 


status 

determining, 202 
displaying, 202, 204 
users, setting up, 224 
Printers command (Browse 
menu), 194 
printing, 175 

administrative tools, 178 
commands, 200 
to default printers, 200 
job complete notifications, 
requesting, 201 
LP print service, 179 
multiple copies, 201 
print client, 177, 191 
print packages, 175 
print protocol adapter, 176 
requests, cancelling, 206- 
services, configuring, 193 
SunOS 5.x, 288 
printwheels, tracking with LP 
print service, 183 
priocntl command, 19, 30 
priorities of processes 
changing, 35 
designating, 33 

process file system (procfs), 20 
processes, 19, 304 
classes, 31 
changing, 34 
controlling information, 
27-28 

displaying information, 
27-30 

global priorities, 
displaying, 31 
killing, 25 
monitoring, 19 
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print client, 192 
priorities 
changing, 35 
designating, 33 
ps command, 21 
reports, 22, 24 
runaway processes, 304 
timeshare processes, 
scheduling parameters, 33 
tools, 20 

troubleshooting, 35 
zombies, 305 

PROFS (Process File System), 
129 

PROM (programmable 
read-only memory), 304 
prompt environment variable, 
45 

prtconf command, 258 
prtvtoc (print volume table of 
contents) conunand, 105, 295 
prun command, 20,26 
ps (process status) command, 
19, 21, 297 

reports, 22, 24 

PSl environment variable, 43 
pseudo file systems, see virtual 
file systems 
psig command, 20,26 
pstack command, 20 
pstat command, 297 
pstop command, 20, 26 
prime command, 20, 26 
ptree command, 20, 26 
Public NFS, jee WebNFS 
pwait command, 20, 26 
pwdx command, 20, 26 


0 __ 

QIC format (SCSI tape drives), 
69 

QIC-150 cartridge tapes, 
backing up file systems, 149 
queue logs (LP Print service), 
188 

queueing tasks with Host 
Manager, 169 

R _ 

r mail command, 298 
rack-mounted 1/2-inch tape 
drives, 68 
rc command, 297 
rc.boot command, 297 
rc.local command, 297 
rcO script, 279 
rcl script (SunOS 5.x), 280 
rc2 script (SunOS 5.x), 280 
rc3 script (SunOS 5.x), 281 
rc5 script (SunOS 5.x), 282 
rc6 script (SunOS 5.x), 282 
rep command, 163 
rcS script (SunOS 5.x), 282 
rdump command, 297 
read permissions, granting, 272 
read, execute permissions, 273 
read, write permissions, 273 
read, write, execute 
permissions, 273 
read-only permissions, 273 
reboot command, 14 
Reboot State (run level 6), 12 
rebooting multiuser systems, 

18 

redirecting command output, 

60 


reformatting disks, 94, 108 
registration, users, 240 
rehash command, 248 
remote installation services, 
establishing with Host 
Manager, 169 
remote systems 

activity, checking, 162 
checking, 161 
files, transferring, 163 
load averages, checking, 
161 

longevity, checking, 161 
logging in, 163 
remote-resource sharing state 
(run level 3), 12 
renaming files, 57 
repairing disks, 106 
blocks, 108 
replacing disks, 108 
reports, ps command, 22, 24 
request logs, LP print service, 
189 

reserved UIDs, 213 
reset -s command, 297 
restore command, 297 
restoring file systems, 147-157 
restrictions, shells, 292 
retensioning tapes, 70 
retrieving files 

diskettes, 96 
tapes, 75-76 
rewinding tapes, 70 
RFS (remote file sharing), 127, 
283 

rfstart command, 295 
rfstop command, 295 
rlogin command, 162-163 
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rm_client command, 298 

i 

search paths 

share command, 295 

root, logging in as, 6 

current, displaying, 270 

sharing files 

root password, 5 

setting in shells, 270 

remote CD-ROM drives. 

. setting with Host Manager, 

troubleshooting, 269 

83 

169 

variables, CDE, 46 

servers, 145 

rpcinfo command, 162 

verifying, 271 

SHELL environment variable. 

run levels 

section numbers, finding in 

45 

changing, 12 

manual pages, 61 

shells, 243,304 

choosing, 11 

security 

changing from command 

runaway processes, 304 

ASET, 292 

line, 244 

rup command, 161 

Kerberos, 293 

commands, 243 

rusage command, 298 

NIS+, 173 

exiting, 244 

rusers -1 command, 53-54 

SunOS 4.x, 291 

restrictions, 292 

rwall command, 298 

SunOS 5.x, 291-292 

windows, clearing, 244 


sending messages, 8 

shutdown command, 10, 13, 

1 s . 

1 —. —■»' —. 

e-mail, 10 

18, 278,298 

1 S5FS, 127 

universally, 9 

shutting down 

sacadm command, 121, 288 

sendmail program, 224 

grace periods, changing, 

S AF (Service Access Facility), 

Serial Port Manager (Solstice 

18 

65,112,304 

AdminSuite), 51 

multiuser systems, 18 

alphanumeric terminals. 

Serial Ports command (Browse 

single-user systems, 19 

administration, 115 

menu), 113 

SunOS 5.x, 278 

modems, administration. 

servers, 304 

systems, 10, 17-18 

115 

boot servers, 169 

on-the-fly, 19 

port monitor, 114 

files, sharing, 145 

without confirmation, 

printer ports, monitoring. 

install servers, 169 

18 

: 115 

print servers, 193 

single-user state (run level S), 

sar command, 293 

configuring, 196-197 

12 

/shin directory, 286 

Service Access Facility (SAF), 

booting, 14 

/sbin/rc directory, 279 

see SAF 

single-user systems, shutting 

scheduling parameters (time- 

set history command, 246 

down, 19 

. share processes), changing, 33 

setsid command, 298 

slices (disks), 304 

scripts, enabling with Host 

setting root passwords with 

choosing, 103 

Manager, 169 

Host Manager, 169 

configuring, 102 

SCSI 1/4-inch cartridge drives, 

sh command, 244 

file systems, 100 

1 69 


x86,103 

SCSI tape drives, 66 



QIC format, 69 
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software, 50 

Print Client, 177 
Solstice AdminSuite 2.3, 
49-51 

Solaris 2.3 volume 
management, changes, 92 
Solaris Common Desktop 
Environment Advanced User’s 
and System Administrator’s 
Guide, 46 

Solstice AdminSuite 2.3,49-51 
sort conunand, 210 
SPECFS (special file system), 
130 

spooling directories, 304 
LP print service, 190 
spooling space, 304 
stand-alone systems, 304 
starting 

Admintool, 49, 112 
SunOS 5.x, 278 
systems, 10 
startup command, 298 
state flags, 304 
status command, 70 
stdout command, 290 
Storage Manager (Solstice 
AdminSuite), 51 
streaming tapes, 70 
stty conunand, 298 
stty erase command, 248 
su (switch user) command, 5 
subsets of files, retrieving on 
tapes, 75 

Sun Microsystems Web site, 51 
suninstall conunand, 298 


SunOS 4.x 

security, 291 
SunOS 5.x command 
equivalents, 293-299 
SunOS 5.x, 3 

configuration, 277 
contents, 278 
device-naming 
conventions, 287 
directories, 283 
file systems, 130-131, 283 
installation, 277 
naming services, 289 
printing, 288 
rcO script, 279 
rcl script, 280 
rc2 script, 280 
rc3 script, 281 
rc5 script, 282 
rc6 script, 282 
security, 291-292 
shutting down, 278 
starting, 278 
SunOS 4.x command 
equvalents, 293-299 
TCP/IP user interface, 289 
UUCP (UNIX-to-UNIX 
Copy), 289 
superusers, 5-6, 304 
swap command, 264 
swap files, 304 
swap space, configuring, 264 
SWAPFS, 130 
swapon command, 298 
symbolic links, 304 
/sys directory, 286 
sys-config command, 298 
sysdef -h command, 257 
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system administrator state (run 
level 1), 11 

system administrators, 3 
duties, 3-4 

users, comunication with, 

6 

system states, 10 
systems, 304 
booting, 14 

configuration, displaying, 
258 

converting with Host 
Manager, 168 
date and time, 
determining/setting, 263 
environments, 
displaying/setting, 43 
files, transferring, 163 
hardware 
adding, 16 
determining, 257 
local mail aliases, creating, 
266 

longevity, determining, 
262 

OS release levels, 
determining, 257 
remote systems, checking, 
161 

shutting down, 10, 17-18 
on-the-fly, 19 
without cofirmation, 18 
stand-alone systems, 304 
starting up, 10 
swap space, configuring, 
264 
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system-specific 
information, displaying, 
257 

time zones, changing, 263 
updating with Host 
Manager, 168 
system-specific messages, 
displaying at login, 7 

T__ 

table of contents (tapes), 
listing, 74 

tables, NIS+, 170, 172 
tape drives 

controllers, abbreviations, 
67 

densities, specifying, 67 
front-loaded 1/2-inch reel 
drives, 69 

helical scan drives, 69 
logical unit numbers, 66 
naming conventions, 
66-67 

no-rewind option, 67 
rack-mounted 1/2-inch 
reel drives, 68 
SCSI, 66, 69 

specifying default density, 
66 

status, displaying, 70 
Xylogics 472,66 
tapes, 65 

directories 

copying to, 70 
retrieving, 72 
tapes, 74 


files 

appending, 72 
copying, 70, 76 
listing, 71 

retrieving, 72, 75-76 
retensioning, 70 
rewinding, 70 
streaming, 70 
table of contents, listing, 
74 

tar command, 70-71, 90, 95 
TCP/IP, user interface, 289 
telinit, 13 

telinit /init command, 14 
TERM environment variable, 
45 

terminals, naming conventions, 
288 

TERMINFO environment 
variable, 45 
Text Editor, 58 
text strings, file searches, 39 
tfsd command, 298 
time zones, changing, 263 
timeshare processes (schedul¬ 
ing parameters), changing, 33 
tip command, 122 
TMPFS (Temporary File 
System), 128 
touch command, 57 
transferring files (systems), 

163 

troff command, 290 
troubleshooting 
ownership, 271 
permissions, 271 


processes, 35 
search paths, 269 
volume management, 91 
trpt command, 298 
tset command, 298 
ttysoftcar command, 298 
TZ environment variable, 45 
tzsetup command, 299 

u_ 

UFS, 126, 305 

diskettes, formatting, 94 
files, copying, 95 
ufsdump command, 148, 295 
ufsrestore command, 110,149 
UIDs (user IDs), 305 
large, 213 
numbers, 213 
reserved, 213 
settings, finding, 55 
umask command, 222 
umountcommand, 111, 135, 
299 

umount_tfs command, 299 
umountall command, 135 
uname command, 293 
uname -m command, 257 
uname -r command, 257 
unit characters, tape drive 
names, 67 

universally sending messages, 
9 

UNIX, 3 

AT&T System V, 3 
Berkeley, 3 
shells, 243, 304 
SunOS 5.x, 3 
unload command, 299 
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unmounting file systems, 
140-143 

unset4 command, 299 
update command, 299 
updating systems with Host 
Manager, 168 
uptime command, 262, 299 
user IDs, see UIDs 
User List field, 236 
User Manager (Solstice 
AdminSuite), 51 
user masks, 305 
User Registration, 239 
useradd command, 209 
userdel command, 210 
usermod command, 210 
users, 305 
accounts 

disabling, 233 
modifying, 230 
setting up, 219-224 
adding, 212 

Admintool, 227-230 
administering 

Admintool, 230-232 
tools, 209 

communication with, 6 
deleting, 232-233 
information, finding, 53 
logons, determining, 53 
mail accounts, 
configuring, 224 
messages, sending, 8 
passwords, creating, 
225-227 

printers, setting up, 224 


registration, 240 
superusers, 5-6 
UIDs, jee UIDs 
users command, 299 
Users command (Browse 
menu), 228 
/usr directory, 286 
/usr/proc/bin directory, 26 
/usr/sbin directory, 287 
utilities 

Admintool, 49 
AutoFS, 144 
Host Manager, 167 
port manager, 114 
sendmail, 224 
Text Editor, 58 
User Registration, 239 
UUCP (UNIX-to-UNIX 
Copy), 289 
uulog command, 299 
uusend command, 299 

V__ 

/var directory, 287 
/var/sadm /instalFcontents file, 
278 

variables 

C shell, defining, 46 
CDE, 46 

environment, 43-45 
defining, 46 
displaying settings, 47 
PATH, 48 
input, 303 
Korn, defining, 46 
LANG, 223 
LC, 223 
VFS, 125 


vi (visual editor) command, 

58-59 

viewing 

boot messages, 15 
files, 40-41 
manual pages, 61 
vipw command, 299 
virtual file system table, 131 
virtual file systems, 127 
virtual memory, 305 
vmstat command, 299 
volcheck command, 86 
volcopy command, 135 
volume management 
CD-ROMs, 77, 82 
mount points, 81 
disabling, 93 
diskettes, 85 
files, 78-81 
troubleshooting, 91 
workman, 92 
vswap command, 299 

w_ 

wall command, 299 
WebNFS, 126 
whatis command, 61 
whereis command, 299 
which command, 271 
who -b command, 262 
who command, 53 
whoami command, 299 
whodo command, 53-54 
windows 

Add Group, 238 
Command Tool, opening, 
16 
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File Manager CD-ROM, 
83 

Modify User window, 231 
shells, clearing, 244 
Users window, 227 
worknaan, volume 
management, 92 
write, execute permissions, 273 
write-only permissions, 273 

xz _ 

x86 slices (disks), 103 
Xylogics 472 tape drives, 66 

ypbatchupd command, 299 
yppasswd command, 299 
ypserv command, 299 

zombies, 305 
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